> ## 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. # Create or update artifact version > Create or update an artifact version. ## OpenAPI ````yaml /openapi.json put /api/ml/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: app.truefoundry.com description: Control Plane URL security: [] tags: - name: Agent - name: Agent Skills - name: Applications - name: Apply - name: Artifacts - name: Audit Logs - name: Clusters - name: Jobs - name: Logs - 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 paths: /api/ml/v1/artifact-versions: put: tags: - Artifacts summary: Create or update artifact version description: Create or update an artifact version. operationId: apply_artifact_version_v1_artifact_versions_put requestBody: content: application/json: schema: $ref: '#/components/schemas/ApplyArtifactRequest' required: true responses: '200': description: The created or updated artifact version content: application/json: schema: $ref: '#/components/schemas/GetArtifactVersionResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - jwt: [] components: schemas: ApplyArtifactRequest: properties: manifest: allOf: - $ref: '#/components/schemas/ArtifactManifest' title: Manifest description: Manifest containing metadata for the artifact to apply type: object required: - manifest title: ApplyArtifactRequest x-fern-type-name: ApplyArtifactRequest GetArtifactVersionResponse: properties: data: allOf: - $ref: '#/components/schemas/ArtifactVersion' title: Data description: The artifact version data type: object required: - data title: GetArtifactVersionResponse x-fern-type-name: GetArtifactVersionResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError x-fern-type-name: HTTPValidationError ArtifactManifest: properties: name: type: string maxLength: 256 pattern: ^[A-Za-z0-9_\-]+$ title: Name description: >- Name of the artifact (alphanumeric characters, hyphens, and underscores only, max 256 characters) metadata: type: object title: Metadata description: >- Key value metadata. Should be valid JSON. For e.g. `{"business-unit": "sales", "quality": "good", "rating": 4.5}` ml_repo: type: string pattern: ^[a-zA-Z][a-zA-Z0-9\-]{1,98}[a-zA-Z0-9]$ title: Ml Repo description: >- Name of the ML Repo that this artifact belongs to (must start and end with alphanumeric, 2-100 characters) version: type: integer minimum: 1 title: Version description: Version of the entity type: type: string enum: - artifact-version title: Type default: artifact-version description: type: string maxLength: 512 title: Description version_alias: type: string maxLength: 128 pattern: ^v[a-zA-Z0-9.-]*([a-zA-Z0-9]+)$ title: 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) source: oneOf: - $ref: '#/components/schemas/TrueFoundryManagedSource' - $ref: '#/components/schemas/ExternalBlobStorageSource' - $ref: '#/components/schemas/LocalArtifactSource' title: Source discriminator: propertyName: type mapping: truefoundry: $ref: '#/components/schemas/TrueFoundryManagedSource' external: $ref: '#/components/schemas/ExternalBlobStorageSource' local: $ref: '#/components/schemas/LocalArtifactSource' step: type: integer minimum: 0 title: 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 default: 0 run_id: type: string title: Run Id description: ID of the MLRepo Run that generated the artifact version type: object required: - name - metadata - ml_repo - source title: ArtifactManifest description: Artifact Version manifest. x-fern-type-name: ArtifactManifest ArtifactVersion: properties: id: type: string title: Id description: Unique identifier for the artifact version fqn: type: string title: Fqn description: >- Fully qualified name of the artifact version in the format '{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}' created_by_subject: allOf: - $ref: '#/components/schemas/Subject' title: Created By Subject description: >- Subject (user, team, or service account) that created this artifact version created_at: type: string format: date-time title: Created At description: Timestamp when the artifact version was created updated_at: type: string format: date-time title: Updated At description: Timestamp when the artifact version was last updated manifest: allOf: - $ref: '#/components/schemas/ArtifactManifest' title: Manifest description: Manifest containing metadata for a generic artifact version ml_repo_id: type: string title: Ml Repo Id description: ID of the ML Repo that this artifact version belongs to tags: items: type: string type: array title: Tags description: >- List of tags associated with this artifact version for filtering and organization version_alias: type: string title: Version Alias description: Optional human-readable version alias (e.g. v1.0.0) usage_code_snippet: type: string title: Usage Code Snippet description: Code snippet demonstrating how to use this artifact version artifact_id: type: string title: Artifact Id description: ID of the parent artifact that this version belongs to type: object required: - id - fqn - created_by_subject - manifest - ml_repo_id - artifact_id title: ArtifactVersion description: >- Tags, optional version alias, and SDK usage snippet (models, prompts, generic artifacts). x-fern-type-name: ArtifactVersion ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError x-fern-type-name: ValidationError TrueFoundryManagedSource: properties: type: type: string enum: - truefoundry title: Type description: Type of the source uri: type: string pattern: ^(s3|gs|wasbs)://.* title: Uri type: object required: - type title: TrueFoundryManagedSource x-fern-type-name: TrueFoundryManagedSource ExternalBlobStorageSource: properties: type: type: string enum: - external title: Type description: Type of the source uri: type: string pattern: ^(s3|gs|wasbs)://.* title: Uri description: >- URI referencing a path in the blob storage bucket linked to the MLRepo type: object required: - type - uri title: ExternalBlobStorageSource x-fern-type-name: ExternalBlobStorageSource LocalArtifactSource: properties: type: type: string enum: - local title: Type description: Type of the source paths: items: $ref: '#/components/schemas/ArtifactPath' type: array title: Paths description: >- Array of ArtifactPath objects representing the source and destination paths type: object required: - type - paths title: LocalArtifactSource x-fern-type-name: LocalArtifactSource Subject: type: object properties: subjectId: type: string description: Subject ID subjectType: description: Subject type allOf: - $ref: '#/components/schemas/SubjectType' 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 ArtifactPath: properties: src: type: string title: Src description: Local file or folder path dest: type: string title: Dest description: >- Relative path where the file or folder will be uploaded to in the artifact type: object required: - src title: ArtifactPath x-fern-type-name: ArtifactPath SubjectType: type: string enum: - user - team - serviceaccount - virtualaccount - external-identity - role description: >- Type of the authenticated subject. "user" for human users, "serviceaccount" (also known as virtual account) for programmatic access. title: SubjectType x-fern-type-name: SubjectType securitySchemes: jwt: type: http scheme: bearer bearerFormat: JWT ````