My Teams

Create a team

Changed on

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

post/teams

Request

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

Request body

namestring required

Team name.

tagstring required

Team tag (short identifier).

gameIdstring required

Game ID the team competes in.

playlistIdstring required

Game playlist ID.

organizationIdstring required

Owning organization ID. The owner must manage it.

descriptionstring

Optional team description.

platformstring

Optional platform.

regionstring

Optional region.

Response

The team was created.

successtrue required
idstring required

The created team ID.

slugstring required

The created team slug.

timestampstring required

Response generation time (ISO 8601).

Changes