Identity

Learn how to verify your API key and retrieve authenticated user and workspace information using the /whoami endpoint.

Verify API key and get user information

get

Returns information about the authenticated user, API key details, and workspace information. Use this endpoint to verify API key validity, check workspace association, monitor API key expiration, and debug authentication issues.

Authorizations

apiKey

x-api-keystringRequired

Responses

200

OK

application/json

get

/whoami

HTTPcURLJavaScriptPython

GET /whoami HTTP/1.1
Host: api.acolad.ai
x-api-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "user": {
    "id": "text",
    "email": "text",
    "emailVerified": true,
    "name": "text",
    "createdAt": "2026-02-09T09:41:12.674Z",
    "updatedAt": "2026-02-09T09:41:12.674Z"
  },
  "apiKey": {
    "id": "text",
    "name": "text",
    "permissions": null,
    "expiresAt": "2026-02-09T09:41:12.674Z"
  },
  "workspace": {
    "id": "text",
    "name": "text",
    "slug": "text"
  }
}