Organizations

Multi-tenant organization management

📄️ Switch active organization

Switches the authenticated user's active organization context. Re-issues a new access token (and refresh token) scoped to the chosen org. The user must be a member of the target org

📄️ Get invite info

Validates an invitation token and returns the organization name and inviter details. Public endpoint — no authentication required. Used by the accept-invite page to show context before the user logs in

📄️ Accept an invitation

Accepts a pending invitation. Validates the token, verifies the caller's email matches the invited email, adds the user to the organization as the invited role, marks the invitation as accepted, and re-issues a new access token scoped to the new org

📄️ List user organizations

Returns all organizations the authenticated user belongs to, including their role in each org and the org's current billing tier. Also returns the active org_id from the current session

📄️ Create an organization

Creates a new organization for the authenticated user. The user becomes the owner. Respects tier organization limits

📄️ Delete an organization

Permanently deletes an organization. Requires owner role and the user must belong to at least one other org. Links can either be migrated to another org or deleted

📄️ Get organization

Returns org details including the member list with roles and pending invitations. The caller must be a member of the org

📄️ Update organization

Renames an organization. Requires owner or admin role within the org

📄️ Invite a member

Sends an email invitation to join the organization. Requires owner or admin role. Respects tier member limits. Sends an invitation email with a unique token

📄️ Revoke an invitation

Cancels a pending invitation. Requires owner or admin role

📄️ Resend an invitation

Resends the invitation email for a pending invitation. Requires owner or admin role

📄️ Delete org logo

Removes the organization logo from R2 storage. Requires owner or admin role and Pro+ tier

📄️ Get org logo

Serves the organization logo from R2 storage. Public endpoint — no authentication required

📄️ Upload org logo

Uploads an organization logo. Accepts multipart/form-data with a field named 'logo'. Max 500 KB. Accepted formats: image/png, image/jpeg, image/webp, image/svg+xml. Requires owner or admin role and Pro+ tier

📄️ Remove a member

Removes a user from the organization. Owners can remove anyone except the last owner. Admins can remove members but not owners. Any member can remove themselves

📄️ Get org settings

Returns organization-level settings. The query_forwarding_enabled setting is only available on Pro+ tiers

📄️ Update org settings

Updates organization-level settings. query_forwarding_enabled requires Pro+ tier. Caller must be owner or admin