Events (Tracks)

An event is a track within a super event. :slug and :id accept a UUID or slug.

Creating a track is not available via the API - adding a track to a live super event involves payment and must be done from the dashboard.

Read

List tracks GET /organizations/:orgSlug/events

Response

{
  "data": {
    "events": [
      {
        "id": "5c1f8a73-6d2b-4e90-a1c4-7b8e3f0d2a16",
        "name": "Autonomous Agents Track",
        "slug": "autonomous-agents",
        "status": "draft",
        "super_event_id": "2b9d7e10-4c8a-4f23-b6e1-9a3c5d7f0e22"
      }
    ]
  }
}

Get track GET /events/:slug

Response

{
  "data": {
    "event": {
      "id": "5c1f8a73-6d2b-4e90-a1c4-7b8e3f0d2a16",
      "name": "Autonomous Agents Track",
      "slug": "autonomous-agents",
      "status": "final",
      "mode": "onsite",
      "start_at": "2026-07-14T09:00:00.000Z",
      "end_at": "2026-07-16T18:00:00.000Z",
      "tz": "Europe/Berlin"
    },
    "registration_count": 142,
    "team_count": 18
  }
}

List track roles GET /events/:eventId/roles

Response

{
  "data": {
    "roles": [
      {
        "user_id": "b3d8e1f0-2c5a-4e9b-8d17-3f6a0c2b5e94",
        "role": "ORGANIZER",
        "email": "alice.rivera@northwind.io",
        "name": "Alice Rivera"
      }
    ],
    "count": 2
  }
}

Get setup status GET /events/:eventId/setup-status

Response Additional notes

{
  "data": {
    "checklist": {
      "has_name": true,
      "has_dates": true,
      "has_registration_open": false
    },
    "is_ready_for_registration": false,
    "stats": {
      "registrations": 0,
      "teams": 0
    }
  }
}

Write

Update track PATCH /events/:id

Response Request (Body) Additional notes

{
  "data": {
    "event": {
      "id": "5c1f8a73-6d2b-4e90-a1c4-7b8e3f0d2a16",
      "name": "Autonomous Agents Track",
      "status": "final"
    }
  }
}

Delete track DELETE /events/:id

Response

{
  "data": {
    "deleted": true
  }
}

Assign track role POST /events/:eventId/roles

Response Request (Body) Additional notes

{
  "data": {
    "user_id": "c4e9f2a1-5d6b-4f0c-9e28-4a7b1d3c6f05",
    "event_id": "5c1f8a73-6d2b-4e90-a1c4-7b8e3f0d2a16",
    "role": "MENTOR"
  }
}

Remove track role DELETE /events/:eventId/roles/:userId/:role

Response

{
  "data": {
    "deleted": true
  }
}

Open registration POST /events/:eventId/open-registration

Response Additional notes

{
  "data": {
    "registration_opened": true,
    "event": {
      "id": "5c1f8a73-6d2b-4e90-a1c4-7b8e3f0d2a16"
    }
  }
}

Close registration POST /events/:eventId/close-registration

Response

{
  "data": {
    "registration_opened": false,
    "event": {
      "id": "5c1f8a73-6d2b-4e90-a1c4-7b8e3f0d2a16"
    }
  }
}