> ## Documentation Index
> Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Versions

> ListVersions returns authorized history in descending numeric version order.
 Owners can inspect PENDING and FAILED; Readers see only eligible READY versions.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/artifacts/{artifact_id}/versions
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/artifacts/{artifact_id}/versions:
    get:
      tags:
        - Artifact
      summary: List Versions
      description: >-
        ListVersions returns authorized history in descending numeric version
        order.
         Owners can inspect PENDING and FAILED; Readers see only eligible READY versions.
      operationId: c1.api.artifact.v1.ArtifactService.ListVersions
      parameters:
        - in: path
          name: artifact_id
          required: true
          schema:
            description: Identifier of the Artifact whose publication history is requested.
            type: string
        - in: query
          name: page_size
          schema:
            description: >-
              Maximum number of results per page; zero selects the service
              default, 20.
            format: int32
            type: integer
        - in: query
          name: page_token
          schema:
            description: Sealed continuation token from a previous page for this Artifact.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.artifact.v1.ArtifactServiceListVersionsResponse
          description: >-
            ArtifactServiceListVersionsResponse contains currently authorized
            history.
             Discovery is eventual; use GetVersion for canonical publication status.
components:
  schemas:
    c1.api.artifact.v1.ArtifactServiceListVersionsResponse:
      description: >-
        ArtifactServiceListVersionsResponse contains currently authorized
        history.
         Discovery is eventual; use GetVersion for canonical publication status.
      properties:
        list:
          description: Authorized versions in descending numeric order, without duplicates.
          items:
            $ref: '#/components/schemas/c1.api.artifact.v1.ArtifactVersion'
          type:
            - array
            - 'null'
        nextPageToken:
          description: >-
            Sealed continuation token, empty when scanning is complete. A short
            or empty
             page may continue; no raw candidate or denied counts are returned.
          type: string
      title: Artifact Service List Versions Response
      type: object
      x-speakeasy-name-override: ArtifactServiceListVersionsResponse
    c1.api.artifact.v1.ArtifactVersion:
      description: >-
        ArtifactVersion is a redacted publication outcome identified by its
        parent
         and positive numeric ID. It contains no source or executable definition.
         Authorization uses the canonical parent Artifact policy resource; versions
         have no separate entitlement or policy identity.
         READY alone does not grant access: current role eligibility and live parent
         and child records are required, including for a previously published pin.
      properties:
        artifactId:
          description: Identifier of the Artifact that owns this version.
          readOnly: true
          type: string
        createdAt:
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        error:
          description: >-
            Safe failure summary, populated only for FAILED; never source text,
            secrets
             or detailed tool/backend errors. Consumers must enforce this condition.
          readOnly: true
          type: string
        expectedPublishedVersionNumericId:
          description: >-
            Exact publication pointer expected at admission; zero means
            unpublished.
             This expectation is not proof that publication succeeded.
          format: int64
          readOnly: true
          type: string
        numericId:
          description: >-
            Exact positive version number within this Artifact, displayed as
            v40.
             Gaps are allowed; JS clients use strings to preserve the full int64 range.
          format: int64
          readOnly: true
          type: string
        state:
          description: >-
            Publication outcome. PENDING and FAILED are visible only to current
            Owners.
          enum:
            - ARTIFACT_VERSION_STATE_UNSPECIFIED
            - ARTIFACT_VERSION_STATE_PENDING
            - ARTIFACT_VERSION_STATE_READY
            - ARTIFACT_VERSION_STATE_FAILED
          readOnly: true
          type: string
          x-speakeasy-unknown-values: allow
        viewerUrl:
          description: >-
            Server-generated pinned viewer link, not a download capability. Only
            an
             eligible READY version can be opened, with current grants checked each time.
          readOnly: true
          type: string
      title: Artifact Version
      type: object
      x-speakeasy-name-override: ArtifactVersion
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````