Skip to main content
GET
Retrieve current identity

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Caller identity

object
enum<string>
required
Available options:
identity
user_id
string
required

The ID of the authenticated user.

current_teamspace_id
string
required

The teamspace ID this request is scoped to. Resolution depends on the caller type:

  • API keys with "All Teamspaces" access (scopeLevel: "account"): the teamspace selected by the Datagrid-Teamspace header, when that teamspace lives under the same account as the key's home teamspace.
  • API keys with "Selected Teamspaces" access (scopeLevel: "org"): the teamspace selected by the Datagrid-Teamspace header, when it is on the key's teamspace list. A key whose list holds only its home teamspace ignores the header.
  • For either kind of key, the key's home teamspace (the one it was created in) when the header is absent.
  • JWT callers: the Datagrid-Teamspace header when present (and the user is a member), otherwise the user's default teamspace.
teamspaces
object[]
required

All teamspaces the authenticated user is a member of.