API v1.0 · Stable

Developer API

Build on top of CoachDeck. REST endpoints, webhooks, and typed SDKs for sideline integrations.

99.99% uptime

Multi-region edge

OAuth 2.0 + JWT

Scoped API keys

12 webhook events

Signed payloads

Authentication

All requests require a Bearer token issued from your CoachDeck workspace.

curl https://api.coachdeck.app/v1/athletes \
  -H "Authorization: Bearer cd_live_••••••••••••" \
  -H "Content-Type: application/json"

Athletes endpoints

GET/v1/athletes

List athletes with filters (status, position, team)

POST/v1/athletes

GET/v1/athletes/{id}

Get athlete profile with scores

PATCH/v1/athletes/{id}

Update profile or status

DELETE/v1/athletes/{id}

Remove an athlete

Example response

{
  "id": "ath_8x4nq",
  "name": "Jordan Bennett",
  "position": "Midfielder",
  "jersey": 10,
  "team": "Soccer Eagles",
  "status": "shortlisted",
  "scores": {
    "speed": 88, "agility": 76, "skill": 91
  },
  "composite_index": 84.3,
  "rank_percentile": 88
}

Webhooks

athlete.registeredathlete.shortlistedtryout.startedtryout.completedassessment.recordedroster.updatedscout.report.createdorg.upgraded