Organizations

Tags: configuration, organizations

Endpoints

• POST /o/{org_uuid}/join - Join
• GET /o/{org_uuid}/membership - Membership
• GET /o/{org}/config - Config

Join

POST /api/v2/o/{org_uuid}/join

Description:

Organization public configuration

Join an organization and get an org-specific authentication token.

This endpoint:

1. Verifies the user is authenticated
2. Checks if OrgMember exists for this account/org combination
3. Creates OrgMember if it doesn't exist (for internal auth orgs)
4. Generates an org token and sets it as a cookie

This is the "consent screen" completion endpoint for internal auth. For external SSO (OIDC/Google), the OAuth callback handles this instead.

Authorization: Requires scopes:

Parameters:

• org_uuid (String)
• request_data (OrgJoinRequest)

Response: See OrgJoinResponse

---

Membership

GET /api/v2/o/{org_uuid}/membership

Description:

Organization public configuration

Check if the current user is a member of an organization.

Returns membership status and role if member.

Authorization: Requires scopes:

Parameters:

• org_uuid (String)

Response: See dict

---

Config

GET /api/v2/o/{org}/config

Description:

Organization public configuration

Get public configuration for an organization.

This endpoint is unauthenticated and returns only the minimal information needed for the login page (name, logo, SSO settings).

Args: org: Organization identifier (UUID or slug)

Authorization: Requires scopes:

Parameters:

• org (String)

Response: See PublicOrganizationConfig

---