v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

Fetch an agent avatar image

Returns the raw image bytes for an agent's profile picture identified by file. This endpoint is designed for integration partners (such as Slack) that fetch avatar URLs via plain GET requests without bearer token support. Authorization is performed via a short, stable capability token rather than an HTTP header.

The token is an HMAC-based capability tied to the file ID. It does not expire, but it is invalidated when the agent's profile picture is replaced or the agent is deleted — shared caches may continue serving the old image until the Cache-Control max-age of one hour elapses. The endpoint never redirects to a signed storage URL; bytes are served inline so behavior is consistent across storage backends.

All failure modes — invalid file ID, invalid token, file not currently referenced as an agent avatar — return a uniform 404 to avoid acting as an existence oracle.

get/api/v1/files/{file}/avatar

Path parameters

filestring required

File ID of the agent's profile picture (fil_...). Must be currently set as an agent's profile picture within the same app.

Query parameters

tokenstring required

HMAC capability token authorizing access to this specific file. Obtained from the avatar URL minted when the profile picture was set.

Response

Raw image bytes of the agent avatar, served with the file's original content type.