---
title: "Create or update an agent version alias."
method: PUT
path: "/v1/agents/{agent_id}/aliases"
tags: ["beta.agents"]
---

# Create or update an agent version alias.

`PUT /v1/agents/{agent_id}/aliases`

Create a new alias or update an existing alias to point to a specific version. Aliases are unique per agent and can be reassigned to different versions.

## Path parameters

- `agent_id` string, required

## Query parameters

- `alias` string, required
- `version` integer, required

## Response `200`

Successful Response

- AgentAliasResponse
  - `alias` string, required
  - `version` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)