Get started

MCP tools72

Access and context
Work
Ideas
Memory
Context links
Life
Reviews and approvals
Sessions
Tasks
Projects and documents
Files
Briefings
Design

HTTP API416

Identity, sign-in and browser sessions
Accounts, workspaces and personal context
Members and invitations
Launch flags and admission
Agent clients, machine keys and MCP
Suite API credentials
Work board and items
Attention and approvals
Agent sessions and review
Ideas
Memory, sources and Recall
Context links
Projects and Editor
Home dashboard
Calendar
Personal Life
Files and jobs
Briefings
Design and Design evals
Security
Settings and preferences
Data lifecycle: export and deletion
Marketing, docs, legal and contact
Billing and subscriptions
Credits and wallet
Usage metering and spend controls
Search
Presence, page analytics and Updates
Skills
Other operations

Account profile patch

PATCH/v1/account/profile

Signed-in sessionLaunch key coreOperation account_profile_patch

Every person gets a personal account with its own Work root.

Body

expectedVersionnumberRequired
patchobjectRequired

Returns

userKeystringRequired
displayNamenull | stringRequired
versionnumberRequired
status"active"Required
verificationState"purchase_eligible" | "unverified" | "verified"Required
picturenull | object
providerobjectRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.

PATCH/v1/account/profile

curl "$SPECIFY_API_ORIGIN/v1/account/profile" \
  -X PATCH \
  -H "Authorization: Bearer $SPECIFY_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expectedVersion":1,"patch":{}}'

Response

{
  "result": {
    "userKey": "<userKey>",
    "displayName": "<displayName>",
    "version": 1,
    "status": "active",
    "verificationState": "purchase_eligible",
    "provider": {
      "kind": "workos",
      "email": "<email>",
      "emailVerified": false,
      "name": "<name>"
    }
  }
}