Skip to main content
POST
Upload Agent Logo

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.

Headers

string
required
Your API key for authentication.
string
required
multipart/form-data. Most HTTP clients set this for you when you attach a file.

Path Parameters

string
required
The agent’s unique identifier.

Body Parameters

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, with the new logo_file_id and a fresh logo_url.
object
The updated identity. See Get Agent Identity for every field.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt