Users API

Current User

GET /api/v2/users/me

Returns the authenticated identity. The response shape depends on the credential type.

  • Full-access integration keys return the user profile and resolved company.
  • Personal read-only sync keys return a reduced profile and read capabilities. They intentionally omit company and user_type.

Example Request

curl "https://app.keito.ai/api/v2/users/me" \
  -H "Authorization: Bearer kto_xxxxx" \
  -H "Keito-Account-Id: your_company_id"

Example Response Shape

Full-access integration key:

{
  "id": "user_id_here",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "roles": ["administrator", "manager", "member"],
  "user_type": "human",
  "company": {
    "id": "company_id_here",
    "name": "Acme Consulting"
  }
}

For the exact reduced personal sync response, see Personal Read-Only Sync Keys. Do not require company when consuming that key type.