Describe the presenting credential

GET

/v1/tokens/self

Returns tenant, user, credential class, grant ceiling, tenant-wide effective permissions, project scope, expiry, and lastUsedAt for the presenting credential only. A session grant ceiling is null. Rate-limit budget is omitted (W6 shipped before W5; this field is not invented here). lastUsedAt may be up to one flush interval stale.

curl -X GET 'https://api.embodiflow.io/v1/tokens/self' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT'

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Responses

Success

dataobjectrequired
- tenantIdstringrequired
- tenantSlugstringrequired
- userIdstringrequired
- userEmailstring | nullrequired
- credentialClassstringrequired
  Allowed values
  pat
  scim
  service
  session
- tokenPrefixstring | nullrequired
- tokenLastFourstring | nullrequired
- grantCeilingarray<string> | nullrequired
- effectivePermissionsarray<string>required
- scopeAllProjectsone ofrequired
- projectIdsarray<string>required
- expiresAtstring | nullrequired
- lastUsedAtstring | nullrequired
- lastUsedAtNotestringrequired
  Allowed values
  lastUsedAt may be up to one flush interval stale
metaobjectrequired
- requestIdstringrequired

Response example

{
  "data": {
    "tenantId": "string",
    "tenantSlug": "string",
    "userId": "string",
    "userEmail": "string",
    "credentialClass": "pat",
    "tokenPrefix": "string",
    "tokenLastFour": "string",
    "grantCeiling": "project:read",
    "effectivePermissions": "project:read",
    "scopeAllProjects": false,
    "projectIds": [
      "string"
    ],
    "expiresAt": "string",
    "lastUsedAt": "string",
    "lastUsedAtNote": "lastUsedAt may be up to one flush interval stale"
  },
  "meta": {
    "requestId": "string"
  }
}

Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1