v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
Tournament Entry

Accept or decline a tournament invite

Answers an organizer's invite for a team you lead. The invite must still be PENDING; an already-answered or revoked invite answers 400 error_invalid_input.

ACCEPTING IS ENTRY, and carries entry's full refusal set. Supply roster - it is required whenever accept is true, and omitting it is rejected as an invalid request rather than silently failing later. The array must hold at least the tournament's teamSize active members of the invited team, or the request answers 400 error_roster_too_small. Acceptance also enforces the pre-start window (400 error_registration_closed), capacity (409 error_tournament_full), and one live entry per team (409 error_already_entered). On success the response carries the participantId, which is the handle for check-in and withdraw.

DECLINING IS ALWAYS AVAILABLE. roster is ignored when accept is false, and the competitive-ban gate applies only to acceptance - a captain serving a ban can decline an invite so the organizer can move on, but receives 403 error_competitive_banned if they try to accept.

Authority comes from the invite: you must be the captain, co-captain, or organization owner of the invited team. An inviteId belonging to a different tournament answers 404 error_tournament_not_found. Invite IDs are returned by GET /tournaments/{identifier}/me. Requires the tournaments actor entry capability at read-write.

post/tournaments/{identifier}/invites/{inviteId}/respond

Path parameters

identifierstring required

Tournament slug.

Tournament slug.

inviteIdstring required

Tournament invite ID, as returned by GET /tournaments/{identifier}/me for a team you lead.

Tournament invite ID, as returned by GET /tournaments/{identifier}/me for a team you lead.

Request body

acceptboolean required

true to accept the invite and enter the tournament, false to decline it. A competitive ban blocks accepting but never declining.

rosterstring[]

User IDs to register as the team's tournament roster. REQUIRED when accept is true and ignored when it is false. Every entry must be an ACTIVE member of the invited team, and the array must hold at least the tournament's teamSize members - a shorter roster answers 400 error_roster_too_small.

Response

The response was recorded.

acceptedboolean required

Echoes the request's accept flag once the response has been recorded.

participantIdstring

The participant row the acceptance created or reused. Present only when accepted is true; store it, because check-in and withdraw are keyed by it.

timestampstring required

Response generation time (ISO 8601).