Skip to content
DocumentationAPI ReferenceChangelog
API ReferenceTalon Studio v1.0.2-beta

Identity

Read the identity and scopes of the token making the request.

Current token

GET/api/v1/meme:read

Returns the identity and effective scopes of the presented API token. Returned as a flat object, with no data envelope.

Response
tokenobject
The token: id, kind (user | service) and scopes[] — the effective scopes for this request.
orgIdstring (UUID)
workspaceIdstring (UUID) · nullable
Set for workspace-bound tokens; null for org-scoped tokens.
userIdstring (UUID) · nullable
The owning user, for personal (user) tokens; null for service tokens.
Tip
Call /me first to confirm a token's scopes and whether it's org- or workspace-scoped. For a personal token, the scopes shown are recomputed against the owner's current org role on every call — if that role is later downgraded, /me immediately shows the smaller set even though the token record itself was never touched. A service token has no owner, so its scopes are always exactly what was granted at creation.
Request
curl -H "Authorization: Bearer tlk_…" \
  "https://<your-instance>/api/v1/me"
Response
{
  "token": {
    "id": "5e0b…",
    "kind": "user",
    "scopes": ["me:read", "detections:read"]
  },
  "orgId": "8f1c…",
  "workspaceId": null,
  "userId": "a3b2…"
}