Skip to main content
GET
Get user organizations
Lists all organizations a user belongs to. Requires authentication with scope read:organization. Supports both OAuth tokens and API keys.

Permissions

Requires authentication with scope read:organization.

Path Parameters

Authentication

Supports both:
  • OAuth tokens: Authorization: Bearer <oauth_token>
  • API keys: X-API-Key: sk_...

Example Request

Example Response

Response Fields

Each organization includes:
  • Organization ID, name, and slug
  • User’s role in the organization (owner, admin, member)
  • Membership timestamp (when user joined)

Common Errors

401 Unauthorized

Authentication required. Provide a valid OAuth token.

403 Forbidden

Insufficient scope. Required scope: read:organization

Authorizations

X-API-Key
string
header
required

API Key for authentication (format: sk_...)

Path Parameters

id
string
required

Response

Organizations retrieved successfully. Returns array of organizations with user roles and membership info.