Render or retrieve the agent symbol as a PNG
/api/agent-avatars/{version}/{palette}/{file}Render or retrieve the agent symbol as a PNG.
On-demand PNG of the agent symbol (a figure on a rounded tile in one of eight hues, or muted gray before an agent exists) for Slack, the mobile app and e-mail; no agent or organization lookup. The pose sets the status mark: working, thinking, listening and loading draw the running ring, sleepy the paused dot, confused the error dot. Size is the logical edge in pixels and scale the density. Background defaults to transparent; veyra-dark supplies the opaque Veyra Intelligence dark-mode background for Slack exports. Theme defaults to light; dark draws the dark theme's tile and ink, for images shown in the console's dark mode. Successful URLs are immutable for one year and return a content-derived ETag. Cache entries regenerate after deletion.
Authorization
No API key is needed: the token or id in the path, or the request's own signature, authenticates the call. How keys work.
Path parameters
one of: "veyra-v1"one of: "blue", "green", "purple", "orange", "teal", "pink", "amber", "red", "muted"one of: "rest.png", "idle.png", "listening.png", "thinking.png", "working.png", "success.png", "confused.png", "sleepy.png", "loading.png"Query parameters
one of: "16", "20", "24", "32", "40", "48", "64", "96", "128", "256", "512"one of: "1", "2"one of: "transparent", "veyra-dark"one of: "light", "dark"Responses
details names each field that failed.Retry-After seconds.Errors return {"error": "..."}, often with a code and details. See errors and limits.