Organization

Read Current Org

Read the caller's current organization.

Headers

• X-Organization-IDstringoptional

Update Current Org

Update org name, billing email or settings. Audited atomically with the mutation: ORGANIZATION_RENAMED iff name changed, otherwise ORGANIZATION_UPDATED.

Headers

• X-Organization-IDstringoptional

Request body

• namestringoptional
• billing_emailstring (email)optional
• settingsobjectoptional

List Invitations

List pending (unaccepted, unexpired) invitations.

Headers

• X-Organization-IDstringoptional

Create Invitation

Invite a new member to the org. The member_invite OperationSpec enforces max_members, shared with the agent-tool path. The ORG_INVITATION_SENT audit row commits with the invitation.

Headers

• X-Organization-IDstringoptional

Request body

• emailstring (email)required
• rolestringoptional

Revoke Invitation

Revoke a pending invitation. Ownership by the caller's org is checked before delegating, since the service takes only the invitation id; this blocks cross-org deletion.

Path parameters

• invitation_idstring (uuid)required

Headers

• X-Organization-IDstringoptional

List Members

List every member of the caller's org.

Headers

• X-Organization-IDstringoptional

Update Member

Change a member's role. Emits ORG_MEMBER_ROLE_CHANGED; demoting the last owner is refused (RemoveMemberError).

Path parameters

• user_idstring (uuid)required

Headers

• X-Organization-IDstringoptional

Request body

• rolestringrequired

Remove Member

Remove a member from the org, revoking the API keys they owned.

Path parameters

• user_idstring (uuid)required

Headers

• X-Organization-IDstringoptional