Skip to main content
POST
/
leagues
/
{identifier}
/
tickets
/
create
Create a league support ticket
curl --request POST \
  --url https://teambattles.gg/api/v1/leagues/{identifier}/tickets/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject": "<string>",
  "description": "<string>"
}
'
{
  "success": true,
  "ticketId": "<string>",
  "timestamp": "<string>"
}

​
Permission Required

This endpoint requires a league-operator API key bound to the league with the tickets capability set to write.

​
Membership Required

The API key owner must have a MANAGER or higher role in the league, or be a TeamBattles staff member.

​
League Identifier

The {identifier} path parameter accepts a league slug or Convex league ID.

​
Behavior

Creating a ticket opens a league-scoped support workflow with category league, entity type league, and default status open. The ticket is attributed to the API key owner and can be prioritized with low, medium, high, or urgent.

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
identifier
string
required

League slug or Convex league ID.

Body

application/json

Creates a league-scoped support ticket.

​
subject
string
required
Required string length: 1 - 200
​
description
string
required
Required string length: 1 - 2000
​
priority
enum<string>
Available options:
low,
medium,
high,
urgent

Response

The ticket was created.

​
success
boolean
required
​
ticketId
string
required

Created ticket ID.

​
timestamp
string
required

Response generation time (ISO 8601).