---
title: "Configure an AI agent"
method: PATCH
path: "/v1/agents/{id}"
tags: ["Agents"]
---

# Configure an AI agent

`PATCH /v1/agents/{id}`

## Request

- Base URL: `https://api.revdesk.com`
- URL: `https://api.revdesk.com/v1/agents/{id}`
- Auth: HTTP bearer

Update an agent's name, greeting, system prompt, voice, language, or enabled state. Changes are synced to the voice runtime so the next call uses them. Send only the fields you want to change.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string
  - `enabled` boolean
  - `greeting` string, nullable
  - `system_prompt` string, nullable
  - `voice_id` string
  - `language` string

## Response `200`

Success

- object
  - `data` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `enabled` boolean, required
    - `agent_type` 'inbound' | 'outbound' | 'both' | 'unassigned', required
    - `greeting` string, nullable, required
    - `language` string, nullable, required
    - `voice_id` string, nullable, required
    - `business_name` string, nullable, required
    - `business_description` string, nullable, required
    - `system_prompt` string, nullable, required
    - `phone_number` object, nullable, required
      - `id` number, required
      - `phone_number` string, required
      - `provider` string, required
      - `is_active` boolean, required
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict (incl. idempotency conflicts)
- `429`: Rate limited

---

[API](https://skmtc.dev/revdesk/apis/revdesk-v1-api.md) · [All operations](https://skmtc.dev/revdesk/apis/revdesk-v1-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revdesk/apis/revdesk-v1-api/revisions/fcbd43530a48?raw)