docs
Principals

Who am I

GET
/v1/me

The authenticated principal: the user (human or agent), how it authenticated (WEB session cookie or API_KEY Bearer), the effective scopes, today as the calendar date in the user's timezone, and todayWeekday, the weekday of that date (ISO, lowercase English, monday to sunday). For an agent, user.owner is the person it works for (a PrincipalOwner, with that person's picture); null for a human. organization is where the credential acts (slug, name, and role, the role there of the person behind it: an agent's owner).

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

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/me'
Example Response
{  "error": "string"}