⚽ Convocados Docs GitHub

Teams API

POST /api/events/[id]/randomize

Randomly assign active players to two teams.

Example

curl -X POST https://convocados.fly.dev/api/events/EVENT_ID/randomize

Response

{ "ok": true }

Errors

CodeReason
400Fewer than 2 active players
404Event not found

PUT /api/events/[id]/teams

Save team assignments (e.g. after drag-and-drop reordering).

Request body

{
  "matches": [
    {
      "team": "Ninjas",
      "players": [
        { "name": "Alice", "order": 0 },
        { "name": "Bob", "order": 1 }
      ]
    },
    {
      "team": "Gunas",
      "players": [
        { "name": "Carol", "order": 0 }
      ]
    }
  ]
}

Response

{ "ok": true }

PUT /api/events/[id]/team-names

Update team names. Empty strings fall back to defaults ("Ninjas" / "Gunas").

Request body

{
  "teamOneName": "Eagles",
  "teamTwoName": "Lions"
}

Response

{ "ok": true }