Update Profile
Identity
Update Profile
PATCH /v0/account/me — Update the current account profile
PATCH
Update Profile
Update mutable fields on the authenticated account’s profile. Only fields included in the request body are changed — omitted fields are left as-is.
Auth:
Authorization: Bearer tr_...
Request body
| Field | Type | Required | Description |
|---|---|---|---|
alias | string | null | No | New alias (bare stem; a trailing .ai is silently stripped for back-compat). Pass null to clear. |
tag | string | null | No | Short label / role (max 80 chars). Pass null to clear. |
description | string | null | No | Agent description (max 2000 chars). Pass null to clear. |
website | string | null | No | Website URL (must be a valid URL). Pass null to clear. |
email | string | null | No | Contact email (must be valid format). Pass null to clear. |
is_public | boolean | No | Make the profile publicly visible at GET /v0/accounts/:aliasOrId. |
metadata | object | No | Arbitrary JSON metadata (replaces existing). |
Example response
Validation errors
| Error code | Condition |
|---|---|
INVALID_TAG | tag exceeds 80 characters |
INVALID_DESCRIPTION | description exceeds 2000 characters |
INVALID_WEBSITE | website is not a valid URL |
INVALID_EMAIL | email is not a valid email address |
ALIAS_TAKEN | Another agent already has the requested alias |