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

# Upload Agent Logo

> Upload the logo shown on the agent's contact card.

### Overview

Replaces the agent's logo. Send the image as a multipart form upload in a field named `file`, not as JSON. Uploading a logo rebuilds the contact card, so `vcf_file_id` and `vcf_url` change in the response.

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

```bash theme={null}
curl -X POST https://api.bland.ai/v2/agents/{agent_id}/identity/logo \
  -H "authorization: YOUR_API_KEY" \
  -F "file=@logo.png;type=image/png"
```

### Headers

**authorization** `string` *required*

Your API key for authentication.

**content-type** `string` *required*

`multipart/form-data`. Most HTTP clients set this for you when you attach a file.

### Path Parameters

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

The agent's unique identifier.

### Body Parameters

**file** `file` *required*

The logo image. PNG or JPEG only, at most 2 MB, one file per request. A request with no file returns `400 BAD_REQUEST`, and any other image type is rejected with `Logo must be a PNG or JPEG image`.

### Response

Returns the full identity in the same shape as [Get Agent Identity](https://docs.bland.ai/api-v2/get/agents-id-identity.md), with the new `logo_file_id` and a fresh `logo_url`.

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

```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": "5db9aecc-5013-4f97-8592-b0330617a6d0",
    "vcf_file_id": "2ee5217f-562e-477c-8e30-0b1a68e44c2f",
    "vcf_delivery_enabled": false,
    "rcs_enabled": true,
    "bcid_enabled": false,
    "bcid_status": "not_submitted",
    "bcid_submission": null,
    "phone_numbers": [],
    "logo_url": "https://files.bland.ai/agent-identity/5db9aecc-5013-4f97-8592-b0330617a6d0?signature=...",
    "vcf_url": "https://files.bland.ai/agent-identity/2ee5217f-562e-477c-8e30-0b1a68e44c2f?signature=...",
    "created_at": "2026-09-15T05:08:35.092Z",
    "updated_at": "2026-09-15T05:09:02.118Z"
  },
  "errors": null
}
```

```json No File theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "BAD_REQUEST",
      "message": "A `file` image field is required"
    }
  ]
}
```

```json Wrong Type theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "BAD_REQUEST",
      "message": "Logo must be a PNG or JPEG image"
    }
  ]
}
```

***

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.