---
title: "Create Or Update Deployments"
method: POST
path: "/v1/convai/agents/{agent_id}/deployments"
tags: ["Agents Platform"]
---

# Create Or Update Deployments

`POST /v1/convai/agents/{agent_id}/deployments`

Create a new deployment for an agent

## Path parameters

- `agent_id` string, required — The id of an agent. This is returned on agent creation.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyCreateOrUpdateDeploymentsV1ConvaiAgentsAgentIdDeploymentsPost
  - `deployment_request` AgentDeploymentRequest, required
    - `requests` AgentDeploymentRequestItem[], required — List of deployment requests
      - `branch_id` string, required — ID of the branch to deploy
      - `deployment_strategy` AgentDeploymentPercentageStrategy, required
        - `type` 'percentage'
        - `traffic_percentage` number, required — Traffic percentage to deploy

## Response `200`

Successful Response

- AgentDeploymentResponse
  - `traffic_percentage_branch_id_map` object — Map of branch IDs to traffic percentages

## Other responses

- `422` — Validation Error

---

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