Get My Permissions

curl --request GET \
  --url https://api.example.com/api/v1/me/permissions \
  --header 'Authorization: Bearer <token>'

{
  "board_id": "<string>",
  "flags": {},
  "preset_name": "<string>"
}

Get My Permissions

Return the authenticated user’s effective permission flags for a board.

Flags are resolved via resolve_permissions(agent_flags, preset_flags, board_overrides) — the exact same path used by runtime permission checks. Board overrides that restrict flags (ceiling model) appear as False.

Legacy agents (permissions column non-null, flat list) are mapped through map_legacy_permissions first. Agents with no granular data at all default to the full registry (True for everything), matching the historical “full access” compat path.

GET

api

permissions

Get My Permissions

curl --request GET \
  --url https://api.example.com/api/v1/me/permissions \
  --header 'Authorization: Bearer <token>'

{
  "board_id": "<string>",
  "flags": {},
  "preset_name": "<string>"
}

Authorizations

Authorization

string

header

required

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

Query Parameters

board_id

string

required

Board to resolve permissions against

Response

Successful Response

board_id

string

required

flags

Flags · object

required

preset_name

string | null

required

Last modified on May 17, 2026

Run Tick Now List Presets