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

# Update Agent Identity

> Change the agent's contact card fields and delivery settings.

### Overview

Updates the identity fields you send and leaves the rest untouched, so a partial body is fine. Send at least one known field; an empty object returns `400 BAD_REQUEST`.

Changing any card field rebuilds the contact card, so `vcf_file_id` and `vcf_url` change even though you did not send them. Read the identity back with [Get Agent Identity](https://docs.bland.ai/api-v2/get/agents-id-identity.md) if you need the new values.

Requires an admin, owner, operator, or prompter role.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**agent\_id** `string` *required*

The agent's unique identifier.

### Body Parameters

Every field is optional, but the body must contain at least one of them and must be an object. Unknown keys are ignored. String fields are trimmed, and sending `null` clears a field to an empty string.

**display\_name** `string`

The name shown to the recipient. At most 80 characters, and it cannot be set to an empty value once you send the key.

**tagline** `string`

Short line describing the agent. At most 140 characters.

**support\_email** `string`

Contact email. At most 254 characters and must be a valid address.

**website** `string`

Website. At most 2048 characters and must be a valid `http` or `https` URL.

**address** `string`

Postal address. At most 300 characters.

**vcf\_delivery\_enabled** `boolean`

Whether to deliver the contact card automatically.

**rcs\_enabled** `boolean`

Whether rich messaging is allowed for this agent.

**bcid\_enabled** `boolean`

Whether verified caller display is switched on.

### Response

Returns the full identity in the same shape as [Get Agent Identity](https://docs.bland.ai/api-v2/get/agents-id-identity.md), reflecting the update.

**data** `object`

The updated identity. See [Get Agent Identity](https://docs.bland.ai/api-v2/get/agents-id-identity.md) for every field.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed. Validation failures return `400 BAD_REQUEST` with a message naming the field.

```json Response theme={null}
{
  "data": {
    "id": "b88c3ce2-54d4-406c-bd21-733c61556151",
    "org_id": "4bb834b5-8e95-487a-908d-d712a201008c",
    "agent_id": "ec74c83e-5370-450b-9aa0-59757ec25a81",
    "display_name": "Northwind Dental",
    "tagline": "Front desk",
    "support_email": "help@northwind.example",
    "website": "https://northwind.example",
    "address": "",
    "logo_file_id": null,
    "vcf_file_id": "29be0d69-898a-41a2-b875-5aeaae7fbd23",
    "vcf_delivery_enabled": false,
    "rcs_enabled": true,
    "bcid_enabled": false,
    "bcid_status": "not_submitted",
    "bcid_submission": null,
    "phone_numbers": [],
    "logo_url": null,
    "vcf_url": "https://files.bland.ai/agent-identity/29be0d69-898a-41a2-b875-5aeaae7fbd23?signature=...",
    "created_at": "2026-09-15T05:08:35.092Z",
    "updated_at": "2026-09-15T05:08:44.301Z"
  },
  "errors": null
}
```

```json Invalid Email theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "BAD_REQUEST",
      "message": "support_email must be a valid email address"
    }
  ]
}
```

```json Nothing To Update theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "BAD_REQUEST",
      "message": "No identity fields to update"
    }
  ]
}
```

```json Not Found theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Agent not found"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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