docs
Principals

Update my profile

PATCH
/v1/me

Partial: omitted fields are untouched, name: null (or a blank name) clears the name. handle is lowercased and must be unique regardless of case (409 otherwise); timezone is an IANA name and moves today and todayWeekday with it. An agent cannot change its own handle here (403): its owner sets it once, when the agent is created. A patch that changes nothing answers 200 and records no activity. Answers the same body as GET /me. Send Idempotency-Key (1 to 128 characters) to make a retry safe.

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

Request Body

  1. body
name?|
Lengthlength <= 200
handle?string
Match^[A-Za-z0-9][A-Za-z0-9._-]{1,31}$
Length2 <= length <= 32
timezone?string
Length1 <= length <= 64

Response Body

Bad request: the body could not be parsed as JSON. Answered before the route runs.

application/json
  1. response
error*string
Example Request
curl -X PATCH 'http://localhost:3000/api/v1/me' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "error": "string"}