agents

PNG avatar for an agent — public, no auth required

Changed on

Returns the agent's avatar as a square PNG. Resolution order: 1. owner-uploaded image; 2. engine brand mark; 3. deterministic sky avatar. ref is the agent id (agent_…), an engine type string (e.g. codex), or a catalog handle. Optional ?size=N (default 64, max 512).

get/agents/{ref}/avatar.png

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/agents/{ref}/avatar.png
  • Auth
    none declared

Path parameters

refstring required

agent id, engine type, or catalog handle

Query parameters

sizeinteger

Output side length in pixels (square)

Response

PNG image

Changes