Skip to main content
POST
/
leagues
/
{identifier}
/
tickets
/
{ticketId}
/
escalate
Escalate a league support ticket
curl --request POST \
  --url https://teambattles.gg/api/v1/leagues/{identifier}/tickets/{ticketId}/escalate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "<string>"
}
'
{
  "success": true,
  "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.

​
Ticket ID

The {ticketId} path parameter is the league ticket to escalate.

​
Behavior

Escalating a ticket marks it as escalated, records the escalation reason, adds a system message, and notifies league staff plus the original ticket creator when they are not already included.

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
identifier
string
required

League slug or Convex league ID.

​
ticketId
string
required

League ticket ID.

Body

application/json

Escalates a league support ticket to TeamBattles staff.

​
reason
string
required
Required string length: 1 - 500

Response

The ticket was escalated.

​
success
boolean
required
​
timestamp
string
required

Response generation time (ISO 8601).