GET · Bearer

GET /api/v1/me

Summary

Who is calling. Returns account_id, parent_account_id, auth_type (api_key or oauth), key fields or null for OAuth, and workspace {id, inbox_quota} when this account is a sub-account. Also returns lifecycle_emails (on or off), owner_email_style {style, note, source}, notices when usage is at 80 percent of inboxes, monthly sends, or custom domains, and whats_new with the newest two or three user-facing changelog highlights. When the account has no verified owner, owner_recommended tells the agent how to add one with POST /api/v1/inboxes/{id}/owners or owner_email on onboard, and mentions the 50 percent Free send increase for a verified external owner. Any live key can call it. MCP: cooper_whoami. MCP does not mint keys.

Request

This call has no JSON body.

Response

HTTP 200. Sample values illustrate the schema.

{
  "account_id": "acc_example",
  "parent_account_id": "acc_example",
  "auth_type": "api_key",
  "key": {
    "id": "inb_example",
    "name": "string",
    "prefix": "string",
    "inbox_id": "inb_example",
    "permissions": [
      "inbox_read"
    ],
    "expires_at": "2026-10-18T12:00:00.000Z"
  },
  "workspace": {
    "id": "inb_example",
    "inbox_quota": 1
  }
}

Errors

The summary and the OpenAPI operation do not name an error code.

Idempotency

This route does not document Idempotency-Key or client_id.