v1

latestOpenAPI 3.1.0MIT2026-07-1393128198.4 KB
Users

Add organization user by ID

Create or update an OrgUser membership for an existing User. Idempotent: if the user is already a member, their role is updated to the supplied value. Used by automation that holds a userId directly. Requires org admin. Accepts users with email_confirmed=false (e.g. invited but not yet accepted).

post/internal/v1/orgs/{org_id}/users

Path parameters

org_idinteger required

Organization ID.

Request body

userIdinteger required

ID of an existing User to attach to the org.

role'owner' | 'admin' | 'member' | 'viewer' | 'billing_manager' | 'collaborator' required

A user's role within an organization.

Response

Membership created or role updated.