> ## Documentation Index > Fetch the complete documentation index at: https://docs.veri.studio/llms.txt > Use this file to discover all available pages before exploring further. # Promote a version (move an alias) > Point `alias` at `version`. Promotion is an alias move, never a copy; the move and its audit row (actor, from, to, reason) commit in one transaction. `production` and `staging` are the reserved aliases; any other [a-z0-9._-] name is a custom alias. Moving `production` also stages a flip on every multi-adapter fleet currently serving a version of this lineage. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/models/{name}/aliases/{alias} openapi: 3.1.0 info: title: Veri API description: >- REST API for the Veri RL post-training platform. All requests require a Bearer API key (`vk_` prefix). license: name: '' version: 0.1.0 servers: - url: https://api.veri.studio description: Production security: [] tags: - name: Training jobs description: Create, monitor, and manage training jobs. - name: Datasets description: Upload and connect training datasets. - name: Deployments description: Serve trained models and run inference. - name: Volumes description: Persistent file storage mounted into jobs. - name: Models description: Custom model registry deployments serve from. - name: Regions description: Discover available launch regions. - name: GPU description: Live GPU availability by provider and region. - name: Compatibility description: Advisory model and runtime compatibility guidance. - name: Code artifacts description: Upload custom training script bundles. - name: Billing description: Credit balance and transaction history. - name: API keys description: Create and revoke API keys. - name: Account description: The authenticated caller's identity. - name: SSH keys description: Manage SSH key pairs for compute access. - name: Settings description: Account-level integrations (Weights & Biases). - name: Metrics description: Prometheus metrics export for your own observability stack. paths: /v1/models/{name}/aliases/{alias}: post: tags: - Models summary: Promote a version (move an alias) description: >- Point `alias` at `version`. Promotion is an alias move, never a copy; the move and its audit row (actor, from, to, reason) commit in one transaction. `production` and `staging` are the reserved aliases; any other [a-z0-9._-] name is a custom alias. Moving `production` also stages a flip on every multi-adapter fleet currently serving a version of this lineage. operationId: promote parameters: - name: name in: path description: Lineage name required: true schema: type: string - name: alias in: path description: Alias to move (production, staging, or custom) required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/PromoteRequest' required: true responses: '200': description: The alias now points at the version content: application/json: schema: $ref: '#/components/schemas/AliasMoveResponse' '400': description: Invalid alias or version reference, or missing reason '404': description: Lineage or version not found in the caller's workspace '409': description: The alias already points at that version security: - bearerAuth: [] components: schemas: PromoteRequest: type: object required: - version - reason properties: version: type: string description: 'The version to point the alias at: "v6" or "6".' reason: type: string description: 'Why (required): recorded verbatim in the audit trail.' AliasMoveResponse: type: object description: The result of a promote or rollback. required: - object - model - alias - to_version - version - audit - fleet_flips_staged properties: object: type: string description: Always "model_alias_move". model: type: string alias: type: string from_version: type: - integer - 'null' format: int32 description: >- The version the alias pointed at before (absent when the alias was created). to_version: type: integer format: int32 version: $ref: '#/components/schemas/ModelVersionResponse' description: The version the alias now resolves to. audit: $ref: '#/components/schemas/ModelAliasAuditResponse' fleet_flips_staged: type: integer description: |- Multi-adapter fleets serving this lineage on which a flip to the new version was staged (production moves only). The fleet cuts over once every replica has the version loaded — no redeploy. minimum: 0 ModelVersionResponse: type: object description: One version of a lineage (`{name}@v{version}`). required: - object - id - model_id - model - version - name - artifact_type - tags - pinned - status - aliases - created_at properties: object: type: string description: Always "model_version". id: type: string description: Version id (mv...). model_id: type: string description: Lineage id. model: type: string description: Lineage name. version: type: integer format: int32 description: Dense, monotonic version number within the lineage. name: type: string description: 'Human handle: "{model}@v{version}".' custom_model_id: type: - string - 'null' description: |- The library model (custom_models row) whose weights this version is; deploy or attach by this id. artifact_type: type: string description: '''full'' | ''adapter''.' dataset_snapshot_id: type: - string - 'null' description: >- Dataset snapshot (Task 2) or plain dataset id the version was trained on. training_job_id: type: - string - 'null' parent_version_id: type: - string - 'null' description: The version `production` pointed at when this one was registered. tags: type: array items: type: string pinned: type: boolean description: Pinned versions are protected from retention. pinned_at: type: - string - 'null' format: date-time status: type: string description: >- 'ready' | 'purged' (Task 6, VS-84). A purged version still lists — number, tags, audit and scorecards stay — but its weights are deleted and it can no longer be deployed, attached or promoted. purged_at: type: - string - 'null' format: date-time aliases: type: array items: type: string description: Aliases currently pointing at this version. created_by: type: - string - 'null' created_at: type: string format: date-time ModelAliasAuditResponse: type: object description: One audited alias move. required: - id - alias - to_version_id - actor - reason - at properties: id: type: string alias: type: string from_version_id: type: - string - 'null' from_version: type: - integer - 'null' format: int32 to_version_id: type: string to_version: type: - integer - 'null' format: int32 actor: type: string description: Who moved it ("api_key:", "web-proxy", "system:migration"). reason: type: string at: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: API key with the `vk_` prefix. Create one from the dashboard. ````