---
title: "PNG avatar for an agent — public, no auth required"
method: GET
path: "/agents/{ref}/avatar.png"
tags: ["agents"]
---

# PNG avatar for an agent — public, no auth required

`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

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

## Path parameters

- `ref` string, required

## Query parameters

- `size` integer

## Response `200`

PNG image

## Other responses

- `404`: Unknown ref

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)