Sign in
organizations

Current organization + permissions for the authenticated user

Changed on

Return the caller's organization and the capabilities they hold in it.

HTTP 200 — the user is onboarded (has a membership). HTTP 404 — the user is gated (no membership yet).

get/organizations/current{format}

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP bearer
    • API key in cookie sessionid

Path parameters

format'.json' required

Headers

X-Organization-Idstring

Selects the active organization for this request. Optional for callers that belong to exactly one active organization — the single membership is resolved implicitly. Required when the caller has two or more active memberships; omitting it in that case returns 400. If the header names an organization the caller is not an active member of, the server returns 403.

Response

permissionsstring[] required

Capabilities this membership confers in this organization, as app_label.codename strings (for example organizations.manage_members). Resolved from the membership's groups and direct grants -- the same source every server-side authorization check reads -- so a client can gate UI on the exact string the API will enforce. Only organization-scoped capabilities appear: a global Django permission or superuser status grants nothing here, because it grants nothing in this organization either. An inactive membership resolves an empty list. The set of possible values grows over time; treat an unrecognised entry as an unknown capability rather than an error.

organizationobject required

Serialize the related organization using OrganizationSerializer.

can_manage_brandingboolean required

Whether this membership can manage branding.

Computed from organizations.manage_branding plus parentless-and- entitled eligibility. Uses organizations.permissions.is_branding_eligible_organization for that eligibility, matching GET /branding/ and logo-upload signing.

Changes

  • bbeb063561c2Revision changes
    • ▲

      removed the required property from the response with the status

    • ○

      added the required property to the response with the status

  • a5fdf3d27f1aRevision changes
    • ○

      added the required property to the response with the status