My Organizations

Create an organization

Changed on

Creates a new organization as the personal API key owner. The owner becomes the organization owner. Role ceilings and cascades are enforced exactly as in the web app. Requires orgs.profile:read-write and API writes access. Supports an optional Idempotency-Key header for safe retries.

post/orgs

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/orgs
  • Auth
    HTTP bearer

Request body

namestring required

Organization name.

tagstring required

Organization tag (short identifier).

descriptionstring

Optional organization description.

Response

The organization was created.

successtrue required
idstring required

The created organization ID.

slugstring required

The created organization slug.

timestampstring required

Response generation time (ISO 8601).

Changes