List organizations

Lists the organizations you belong to, with your role and permissions in each. Site administrators get the full list (paged, sortable, filterable by status) unless they send mine: true.

Requires a signed-in user token (Authorization: Bearer cliq_tok_…). Results are limited to what that user can see.

POST /v1/orgs/get

List organizations

cURL

curl --request POST \
  --url https://{host}/v1/orgs/get \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "mine": true
}'

200

{
  "ok": true,
  "data": {
    "orgs": [
      {
        "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
        "slug": "acme",
        "display_name": "Acme Inc.",
        "member_count": 12,
        "scope_count": 2,
        "my_role": "admin",
        "created_at": "2026-01-10T00:00:00Z",
        "permissions": [
          "teams.install",
          "runs.view"
        ],
        "owner": {
          "username": "sshah",
          "status": "active"
        }
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

User PAT (cliq_tok_…, including session-scoped) or realm token (cliq_dt_…).

Body

application/json

query · string

Substring match on slug or display_name

limit · integer

Maximum number of results to return (1–100)

Required range: 1 <= x <= 100

offset · integer

Zero-based offset for pagination

Required range: x >= 0

mine · boolean

When true, return only orgs the caller is a member of (ignores admin privileges)

sort_by · enum<string>

Sort column: slug | display_name | member_count | scope_count | created_at. Omit for the default order (exact slug match first when searching, then newest first; site-admin list only — 400 with mine).

Available options: slug, display_name, member_count, scope_count, created_at

sort_dir · enum<string>

Sort direction with sort_by (default asc); ties are broken by id ascending

Available options: asc, desc

status · enum<string>

Site-admin list only: only orgs in this state (deleted lists soft-deleted orgs)

Available options: active, waiting_for_owner, deleted

include_deleted · boolean

Site-admin list only: also list soft-deleted orgs

Response

200

application/json

Success.

ok · enum<boolean> · required

Always true on success.

Available options: true

data · object · required

Show child attributes