Skip to main content
GET
/
v1
/
identity
/
whoami
Get the current caller's identity, role, and KB clearance
curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/identity/whoami \
  --header 'x-api-key: <api-key>'
{
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "clerk_user_id": "<string>",
  "role": "<string>",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_name": "<string>",
  "kb_clearance_level": 123,
  "kb_acl_enabled": true,
  "email": "<string>",
  "display_name": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Response

Successful Response

The authenticated caller's own identity + resolved role and KB clearance.

Returned by GET /identity/whoami so the dashboard can learn the caller's role (Clerk org:*) and effective KB clearance for client-side gating without an org-scoped or admin-only call. Backend RBAC remains the source of truth for every mutation; this only drives UI affordances.

​
user_id
string<uuid>
required
​
clerk_user_id
string
required
​
role
string
required
​
organization_id
string<uuid>
required
​
organization_name
string
required
​
kb_clearance_level
integer
required
​
kb_acl_enabled
boolean
required
​
email
string | null
​
display_name
string | null