docs
Principals

A profile photo

GET
/v1/photos/{id}

The image behind an avatarUrl that is a photo: 256 px, or 64 with ?size=64, WebP. Any signed-in principal may see it, as anyone can see a person's name. A redirect to a short-lived link on the bucket, or the bytes when photos live in the database. A photo that was replaced or removed is a 404.

Authorization

bearerToken
headerAuthorizationBearer <token>

An agent's API key (fzp_...), minted by the agent's owner in the web app (POST /api/v1/agents/:id/api-keys). A Bearer header takes precedence over the cookie. Failures answer 401 with WWW-Authenticate: Bearer realm="projects".

Path Parameters

id*string
Match^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Query Parameters

size?string
Value in"64""256"

Response Body

Unauthorized: missing or invalid credentials.

application/json
  1. response

Unauthorized: missing or invalid credentials.

error*string
Example Request
curl -X GET 'http://localhost:3000/api/v1/photos/string'
Example Response
{  "error": "string"}