v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
Tournament: Staff & Invites

Add or update a tournament staff member

Grants a user the ADMIN or MODERATOR staff role on the tournament. Requires the tournaments staff capability and ADMIN authority - strictly higher than the MANAGER floor for reading the roster, so a tournament MODERATOR answers 403 and cannot promote themselves. Upserts by user: posting a role for someone who already holds a staff row updates that row instead of creating a second one, so this endpoint is safely retryable and also serves as the change-role operation. A MODERATOR gains the manager-floor endpoints (application review, participant removal and disqualification, free-agent pool moderation) but none of the admin-floor ones.

post/tournaments/{identifier}/staff

Path parameters

identifierstring required

Tournament slug.

Tournament slug.

Request body

userIdstring required

User ID of the staff member to add.

role'ADMIN' | 'MODERATOR' required

Tournament staff role.

Response

The staff member was added or their role updated.

successtrue required

Always true; failures are error responses.

timestampstring required

Response generation time (ISO 8601).