> ## Documentation Index
> Fetch the complete documentation index at: https://www.bolna.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rename agent version API

> Rename a Bolna voice agent version or replace its tags without changing its configuration.

Changes a version's `version_name` or `tags`. The configuration doesn't change, and this works on the live version too.

* A rename applies to every save of the version.
* Renaming to a name another version of the agent uses returns `409`.
* `tags` replaces the tags of the save you pass.
* Other fields return `422`. To change the configuration, use [Update agent version](https://www.bolna.ai/docs/api-reference/agent/v2/versions/update.md).


## OpenAPI

````yaml PATCH /v2/agent/{agent_id}/versions/{agent_version_id}
openapi: 3.1.0
info:
  title: Bolna API
  description: >-
    Use and leverage Bolna Voice AI using APIs through HTTP requests from any
    language in your applications and workflows.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.bolna.ai
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: SIP trunks
    description: >-
      Bring-your-own-carrier SIP trunks, their gateways, carrier IPs and
      numbers.
paths:
  /v2/agent/{agent_id}/versions/{agent_version_id}:
    patch:
      description: >-
        Rename a version or replace its tags. The live agent's configuration
        doesn't change.
      parameters:
        - in: path
          name: agent_id
          required: true
          description: The agent's `id`
          schema:
            type: string
            format: uuid
        - in: path
          name: agent_version_id
          required: true
          description: >-
            The version's `id`, from [List agent
            versions](/api-reference/agent/v2/versions/list)
          schema:
            type: string
            format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentVersionPatchRequest'
            example:
              version_name: Holiday offer
        required: true
      responses:
        '200':
          description: Version updated
          content:
            application/json:
              example:
                message: Agent version updated successfully
        '404':
          description: Agent or version not found
          content:
            application/json:
              example: Agent version not found
        '409':
          description: Another version of this agent already has this name
          content:
            application/json:
              example: Another version already has this name
components:
  schemas:
    AgentVersionPatchRequest:
      type: object
      additionalProperties: false
      properties:
        version_name:
          type: string
          description: >-
            New name for the version. Must not be used by another version of the
            agent.
        tags:
          type: array
          items:
            type: string
          description: Replaces the version's tags
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.