---
title: "Edit Assistant"
method: PATCH
path: "/agent/v1"
tags: ["agent"]
---

# Edit Assistant

`PATCH /agent/v1`

Updates an existing assistant with new configuration settings. Each operation requires specific fields to be provided.

## Headers

- `X-API-KEY` string, required

## Request body

- object
  - `operation` 'attach_inbound_number' | 'remove_inbound_number' | 'attach_kb' | 'remove_kb' | 'edit_custom_vars' | 'edit_language' | 'edit_voice' | 'edit_prompt' | 'edit_noise_settings' | 'edit_agent_display_name' | 'edit_intro_message' | 'edit_query_phrases' | 'edit_dtmf_settings' | 'edit_vad_settings' | 'edit_agent_whitelisted_domains' | 'edit_voice_speed' | 'edit_extract_callee_name' | 'edit_vocab' | 'edit_api_settings' | 'edit_secondary_language' | 'edit_secondary_voice', required
  - `agent_id` string, required
  - `agent_display_name` string
  - `language` 'en-US' | 'en-IN' | 'hi-IN' | 'ta-IN' | 'te-IN' | 'kn-IN' | 'mr-IN' | 'gu-IN' | 'ar-AE'
  - `voice_id` string
  - `secondary_voice_id` string
  - `secondary_language` 'en-US' | 'en-IN' | 'hi-IN' | 'ta-IN' | 'te-IN' | 'kn-IN' | 'mr-IN' | 'gu-IN' | 'ar-AE'
  - `agent_prompt` union
    - string
    - object
      - `prompt_sections` object[]
        - `section_title` string
        - `section_content` string
  - `custom_variables` string[]
  - `number_id` string
  - `kb_id` string
  - `whitelisted_domains` string[]
  - `voice_speed` number

## Response `200`

Successful Response: Assistant updated successfully.

- object
  - `message` string
  - `agent_id` string

## Other responses

- `400` — Bad Request - Invalid parameters or request format.
- `401` — Unauthorized - Invalid or missing API key.
- `404` — Not Found - Assistant not found.
- `500` — Internal Server Error - Something went wrong on our end.

---

[API](https://skmtc.net/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.net/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/versions/00b614a7714c/schema)