> ## 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](/api-v2/get/agents-id-identity) if you need the new values.

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

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="agent_id" type="string" required>
  The agent's unique identifier.
</ParamField>

### 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.

<ParamField body="display_name" type="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.
</ParamField>

<ParamField body="tagline" type="string">
  Short line describing the agent. At most 140 characters.
</ParamField>

<ParamField body="support_email" type="string">
  Contact email. At most 254 characters and must be a valid address.
</ParamField>

<ParamField body="website" type="string">
  Website. At most 2048 characters and must be a valid `http` or `https` URL.
</ParamField>

<ParamField body="address" type="string">
  Postal address. At most 300 characters.
</ParamField>

<ParamField body="vcf_delivery_enabled" type="boolean">
  Whether to deliver the contact card automatically.
</ParamField>

<ParamField body="rcs_enabled" type="boolean">
  Whether rich messaging is allowed for this agent.
</ParamField>

<ParamField body="bcid_enabled" type="boolean">
  Whether verified caller display is switched on.
</ParamField>

### Response

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

<ResponseField name="data" type="object">
  The updated identity. See [Get Agent Identity](/api-v2/get/agents-id-identity) for every field.
</ResponseField>

<ResponseField name="errors" type="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.
</ResponseField>

<ResponseExample>
  ```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"
      }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)