> ## Documentation Index > Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt > Use this file to discover all available pages before exploring further. # List artifact versions > List artifact versions with optional filtering by tag, FQN, artifact ID, ML Repo, name, version, run IDs, or run steps. ## OpenAPI ````yaml /openapi.json get /api/svc/v1/artifact-versions openapi: 3.1.0 info: title: TrueFoundry API description: API for TrueFoundry version: 0.1.0 contact: {} servers: - url: https://{controlPlaneURL} variables: controlPlaneURL: default: example-company.truefoundry.cloud description: Control Plane URL security: [] tags: - name: Agent - name: Agent Skills - name: Applications - name: Metrics - name: Apply - name: Artifacts - name: Audit Logs - name: Clusters - name: Jobs - name: LLM Gateway Budgets - name: Logs - name: MCP Registry - name: MCP Servers V2 - name: MLRepos - name: Model Deployments - name: Models - name: Personal Access Tokens - name: Prompts - name: Provider Integrations - name: SCIM v2 - name: Secret Groups - name: Secrets - name: Teams - name: Traces - name: Users - name: Virtual Accounts - name: Role Bindings - name: Workspaces - name: Provider Accounts paths: /api/svc/v1/artifact-versions: get: tags: - Artifacts summary: List artifact versions description: >- List artifact versions with optional filtering by tag, FQN, artifact ID, ML Repo, name, version, run IDs, or run steps. operationId: ArtifactVersion.listArtifactVersions parameters: - name: limit required: false in: query description: Number of items per page schema: minimum: 1 maximum: 1000 nullable: true default: 100 example: 10 type: integer - name: offset required: false in: query description: Number of items to skip schema: minimum: 0 nullable: true default: 0 example: 0 type: integer - name: tag required: false in: query description: Tag to filter artifact versions by. schema: type: string nullable: true - name: fqn required: false in: query description: Fully Qualified Name uniquely identifying the artifact version. schema: type: string nullable: true - name: artifact_id required: false in: query description: Identifier of the artifact whose versions to list. schema: type: string nullable: true - name: ml_repo_id required: false in: query description: Identifier of the ML Repo the artifact versions belong to. schema: type: string nullable: true - name: name required: false in: query description: Name of the artifact version. schema: type: string nullable: true - name: version required: false in: query description: Version number (positive integer) to filter by. schema: type: integer nullable: true - name: run_ids required: false in: query description: Run IDs to filter artifact versions by. schema: nullable: true type: array items: type: string - name: run_steps required: false in: query description: Run steps to filter artifact versions by. schema: nullable: true type: array items: type: number - name: include_internal_metadata required: false in: query description: Whether to include internal metadata in the response. schema: type: boolean default: false responses: '200': description: >- List of artifact versions matching the query with pagination information content: application/json: schema: $ref: '#/components/schemas/ListArtifactVersionsResponse' security: - jwt: [] components: schemas: ListArtifactVersionsResponse: type: object properties: data: description: List of artifact versions matching the query. type: array items: $ref: '#/components/schemas/ArtifactVersion' pagination: description: Pagination information for the response. allOf: - $ref: '#/components/schemas/Pagination' required: - data - pagination title: ListArtifactVersionsResponse x-fern-type-name: ListArtifactVersionsResponse ArtifactVersion: type: object properties: created_at: format: date-time type: string description: Timestamp when the artifact version was created. nullable: true updated_at: format: date-time type: string description: Timestamp when the artifact version was last updated. nullable: true manifest: description: Manifest describing the artifact version. oneOf: - $ref: '#/components/schemas/ArtifactManifest' id: type: string description: System-generated artifact version ID. example: jqfwg345gi25n5ju2yz5iz6m fqn: type: string description: Human-readable Fully Qualified Name of the artifact version. created_by_subject: description: >- Subject (user, team, or service account) that created the artifact version. allOf: - $ref: '#/components/schemas/Subject' ml_repo_id: type: string description: Identifier of the ML Repo the artifact version belongs to. usage_code_snippet: type: string description: Code snippet demonstrating how to use the artifact version. nullable: true tags: description: Tags associated with the artifact version. default: [] nullable: true type: array items: type: string artifact_id: type: string description: Identifier of the artifact this version belongs to. required: - manifest - id - fqn - created_by_subject - ml_repo_id - artifact_id title: ArtifactVersion x-fern-type-name: ArtifactVersion Pagination: type: object properties: total: type: integer description: Total number of items example: 100 offset: type: integer description: Number of items skipped example: 0 nullable: true limit: type: integer description: Number of items per page example: 10 nullable: true required: - total title: Pagination x-fern-type-name: Pagination ArtifactManifest: description: Log a new Artifact Version containing files and folders with metadata type: object properties: type: description: Artifact Version type: string enum: - artifact-version default: artifact-version description: description: Description type: string maxLength: 512 nullable: true version_alias: description: >- Version alias is alternate, ideally human readable, version string to reference an artifact version. It should start with `v` followed by alphanumeric and it can include `.` and `-` in between (e.g. `v1.0.0`, `v1-prod`, `v3-dev`, etc) type: string maxLength: 128 pattern: ^v[a-zA-Z0-9.-]*([a-zA-Z0-9]+)$ source: description: Artifact Source type: object oneOf: - $ref: '#/components/schemas/TrueFoundryManagedSource' - $ref: '#/components/schemas/ExternalBlobStorageSource' - $ref: '#/components/schemas/LocalArtifactSource' discriminator: propertyName: type step: description: >- Step/Epoch number in an iterative training loop the artifact version was created. Generally useful when logging a model version from a MLRepo Run type: integer minimum: 0 default: 0 run_id: description: ID of the MLRepo Run that generated the artifact version type: string allOf: - $ref: '#/components/schemas/BaseArtifactVersion' required: - type - source - step title: ArtifactManifest x-fern-type-name: ArtifactManifest Subject: type: object properties: subjectId: type: string description: Subject ID subjectType: type: string description: Subject type enum: - user - team - serviceaccount - virtualaccount - agent-identity - agent - agent-channel-identity - role subjectSlug: type: string description: Subject slug nullable: true subjectDisplayName: type: string description: Subject display name nullable: true subjectPatName: type: string description: Subject PAT name nullable: true subjectControllerName: type: string nullable: true subjectExternalIdentitySlug: type: string description: External identity slug (external_identity_id:sub:email) nullable: true required: - subjectId - subjectType title: Subject x-fern-type-name: Subject TrueFoundryManagedSource: description: TrueFoundry Managed Source type: object required: - type properties: type: description: Type of the source type: string enum: - truefoundry default: truefoundry uri: description: URI type: string pattern: ^(s3|gs|wasbs)://.* title: TrueFoundryManagedSource x-fern-type-name: TrueFoundryManagedSource ExternalBlobStorageSource: description: External Blob Storage Source type: object required: - type - uri properties: type: description: Type of the source type: string enum: - external default: external uri: description: >- URI referencing a path in the blob storage bucket linked to the MLRepo type: string pattern: ^(s3|gs|wasbs)://.* title: ExternalBlobStorageSource x-fern-type-name: ExternalBlobStorageSource LocalArtifactSource: type: object required: - type - paths properties: type: description: Type of the source type: string enum: - local default: local paths: description: >- Array of ArtifactPath objects representing the source and destination paths type: array items: $ref: '#/components/schemas/ArtifactPath' title: LocalArtifactSource x-fern-type-name: LocalArtifactSource BaseArtifactVersion: type: object required: - metadata properties: name: description: Name of the entity type: string maxLength: 256 pattern: ^[A-Za-z0-9_\-]+$ metadata: description: >- Key value metadata. Should be valid JSON. For e.g. `{"business-unit": "sales", "quality": "good", "rating": 4.5}` type: object ml_repo: description: Name of the ML Repo type: string pattern: ^[a-zA-Z][a-zA-Z0-9\-]{1,98}[a-zA-Z0-9]$ version: description: Version of the entity type: integer minimum: 1 title: BaseArtifactVersion x-fern-type-name: BaseArtifactVersion ArtifactPath: type: object required: - src properties: src: description: Local file or folder path type: string dest: description: >- Relative path where the file or folder will be uploaded to in the artifact type: string title: ArtifactPath x-fern-type-name: ArtifactPath securitySchemes: jwt: type: http scheme: bearer bearerFormat: JWT ````