My Organizations

Add an organization member

Changed on

Adds a user to the organization with the ADMIN or MEMBER role. The caller (key owner) must be an organization admin or owner. Role ceilings and cascades are enforced exactly as in the web app. Requires orgs.roster:read-write and API writes access. Supports an optional Idempotency-Key header for safe retries.

post/orgs/{identifier}/members

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/orgs/{identifier}/members
  • Auth
    HTTP bearer

Path parameters

identifierstring required

Organization slug or Convex organization ID.

Request body

targetUserIdstring required

Convex user ID of the member to add.

role'ADMIN' | 'MEMBER' required

The role to assign to the new member. Ownership is set on creation.

Response

The member was added.

successtrue required
timestampstring required

Response generation time (ISO 8601).

Changes