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

# Update Agent

> StateSet Voice API operation.

StateSet Voice API operation.

### Request body

`AgentPatch`

<ParamField body="business_profile" type="BusinessProfile,null" />

<ParamField body="greeting" type="string,null">
  New greeting line, up to 500 characters
</ParamField>

<ParamField body="instructions" type="string,null">
  New system instructions, up to 8000 characters. Supplying this
  detaches the guided profile — the customer owns the prose from then on.
</ParamField>

<ParamField body="voice" type="string,null">
  New voice id (validated against the voice catalog; see `GET /customer/voices`)
</ParamField>

### Response

No response body — receptionist agent updated; a new version was created and published.

### Status codes

| Code  | Meaning                                                             |
| ----- | ------------------------------------------------------------------- |
| `200` | Receptionist agent updated; a new version was created and published |
| `400` | Unknown voice id, or greeting/instructions exceed the length limit  |
| `404` | Customer self-serve plane disabled                                  |
| `409` | No receptionist agent configured for this tenant                    |

<RequestExample>
  ```bash cURL theme={null}
  curl --request PATCH \
    --url 'https://api.voice.stateset.com/api/v1/customer/agent' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "business_profile": {
      "business_name": "string",
      "description": null,
      "faqs": [
        {
          "answer": null,
          "question": null
        }
      ],
      "hours": null,
      "location": null,
      "notes": null,
      "services": [
        "string"
      ],
      "transfer_to": null
    },
    "greeting": "Hi, thanks for calling Acme!",
    "instructions": "Be concise and friendly.",
    "voice": "eve"
  }'
  ```
</RequestExample>