--- title: "Discover versions of an artifact in a source" canonical: "https://admiral.io/docs/api/sources/SourceAPI_ListSourceVersions" --- # Discover versions of an artifact in a source `GET https://api.admiral.io/v1/sources/{source_id}/versions` FAILED_PRECONDITION when the artifact is outside `allows` or the grant no longer reaches the source. Scope: `source:read` ### Path parameters - `source_id` (string, required): The source_id path parameter. Pattern `^src-[0-9a-z]+$`. ### Query parameters - `artifact` (string): The artifact whose versions to list, as `allows` names it: a chart name, `name/provider`, a name under the namespace. Empty for a git source, whose versions are the repository's tags and branches. Length at most 256. - `page_size` (integer (int32)): The page_size query parameter. Value 0 to 200. - `page_token` (string): The page_token query parameter. ### Response 200 Success - `versions` (array of SourceVersion): Ordered versions newest first, then branches. - `name` (string): The version as the upstream spells it: `1.14.5`, `v2.3.0`, `main`. - `kind` (Kind): Kind says whether the version compares. One of `KIND_UNSPECIFIED`, `KIND_VERSION`, `KIND_BRANCH`. - `commit` (string): For a git source, the commit the tag or branch resolves to. - `created_at` (Timestamp): When the upstream says the version was made, when it says. - `next_page_token` (string) - `refreshed_at` (Timestamp): When the versions were last read from the upstream. - `stale_reason` (string): Set when the upstream failed on this read and the list is the last one that succeeded. Empty when fresh.