Course Maps

Attach Strava and Ride with GPS routes to an event as course maps. OAuth-gated: callers without a current Strava / RWG token receive a structured oauth_required error with a connect_url.

List course maps attached to the event

get

Authorizations

AuthorizationstringRequired

Pass the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Path parameters

handlestringRequired

The unique handle (slug) of the event

Example: nyc_marathon_2025

Responses

200

Course maps

application/json

401

Unauthorized - invalid or missing token

application/json

403

Forbidden - user is not an admin of this event

application/json

404

Event not found

application/json

get/api/v1/events/{handle}/course_maps

GET /api/v1/events/{handle}/course_maps HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Accept: */*

{
  "course_maps": [
    {
      "id": 1,
      "name": "text",
      "provider": "strava",
      "provider_route_id": "text",
      "provider_created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Attach a course map from Strava or Ride with GPS

post

Attaches an existing route owned by the organizer's connected Strava or RWG account. OAuth-gated; returns 422 oauth_required with a connect_url if the corresponding integration isn't connected. Strava routes additionally require the read_all scope; insufficient scope is surfaced as 422 insufficient_scope.

Authorizations

AuthorizationstringRequired

Pass the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Path parameters

handlestringRequired

The unique handle (slug) of the event

Example: nyc_marathon_2025

Body

For Strava routes pass {source: "strava", strava_route_id}. For Ride with GPS pass {source: "ride_with_gps", route_id}.

sourcestring · enumRequiredPossible values:

strava_route_idintegerOptional

route_idintegerOptional

Responses

201

Attached

application/json

401

Unauthorized - invalid or missing token

application/json

403

Forbidden - user is not an admin of this event

application/json

404

Route not found in the athlete's account

application/json

422

OAuth required, insufficient scope, or validation error

application/json

post/api/v1/events/{handle}/course_maps

POST /api/v1/events/{handle}/course_maps HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "source": "strava",
  "strava_route_id": 1,
  "route_id": 1
}

{
  "course_map": {
    "id": 1,
    "name": "text",
    "provider": "strava",
    "provider_route_id": "text",
    "provider_created_at": "2026-01-01T00:00:00.000Z"
  }
}

Detach a course map from the event

delete

Authorizations

AuthorizationstringRequired

Pass the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Path parameters

handlestringRequired

The unique handle (slug) of the event

Example: nyc_marathon_2025

idinteger · int64Required

The ID of the resource

Example: 1

Responses

200

Detached

application/json

okboolean · enumRequiredPossible values:

401

Unauthorized - invalid or missing token

application/json

403

Forbidden - user is not an admin of this event

application/json

404

Event not found

application/json

delete/api/v1/events/{handle}/course_maps/{id}

DELETE /api/v1/events/{handle}/course_maps/{id} HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Accept: */*

{
  "ok": true
}