Add Session
Add one more session to an existing series. A real booking is created for the group on the given schedule slot, appended after the current sessions.
Endpointโ
POST /v1/series/{id}/sessions
Authenticationโ
Requires a live or test API key with series:write scope.
Path Parametersโ
| Parameter | Type | Description |
|---|---|---|
id | integer | Series ID |
Request Bodyโ
| Field | Type | Required | Description |
|---|---|---|---|
schedule_id | integer | Yes | An experience_availability ID of the series' experience โ must be in the future and have enough remaining capacity for the group |
Example Requestโ
curl -X POST "https://app.equipdash.com/api/v1/series/1/sessions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"schedule_id": 504}'
Responseโ
Success (201 Created)โ
Returns the updated series in the same shape as Get Series (without totals โ call Get Series for refreshed totals).
{
"data": {
"id": 1,
"name": "Intro Course โ Tuesday Group",
"experience": {
"id": 12,
"name": "Intro Course"
},
"group": {
"id": 7,
"name": "Tuesday Group"
},
"billing_mode": "consolidated",
"status": "active",
"sessions": [
{
"id": 101,
"session_index": 1,
"schedule": {
"id": 501,
"start_datetime_utc": "2026-09-01T17:00:00Z",
"end_datetime_utc": "2026-09-01T18:30:00Z"
},
"booking": {
"id": 9001,
"status": "confirmed",
"payment_status": "pending"
},
"created_at": "2026-07-20T10:00:00Z",
"updated_at": "2026-07-20T10:00:00Z"
},
{
"id": 104,
"session_index": 2,
"schedule": {
"id": 504,
"start_datetime_utc": "2026-09-22T17:00:00Z",
"end_datetime_utc": "2026-09-22T18:30:00Z"
},
"booking": {
"id": 9004,
"status": "confirmed",
"payment_status": "pending"
},
"created_at": "2026-07-21T09:30:00Z",
"updated_at": "2026-07-21T09:30:00Z"
}
],
"created_at": "2026-07-20T10:00:00Z",
"updated_at": "2026-07-21T09:30:00Z"
},
"meta": {
"request_id": "req_abc123"
}
}
Errorsโ
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 403 | insufficient_scope | API key lacks series:write scope |
| 403 | forbidden | Series belongs to a different supplier |
| 404 | resource_not_found | Series does not exist |
| 422 | validation_failed | schedule_id missing, or the slot does not belong to the series' experience |
| 422 | business error | The slot is in the past or lacks capacity for the group |