Delete Schedule
Delete a schedule slot. Cannot delete schedules that have bookings.
Endpointโ
DELETE /v1/experiences/{id}/schedules/{scheduleId}
Authenticationโ
Requires an API key with the experiences:write scope.
Path Parametersโ
| Parameter | Type | Description |
|---|---|---|
id | integer | Experience ID |
scheduleId | integer | Schedule ID |
Example Requestโ
curl -X DELETE "https://app.equipdash.com/api/v1/experiences/1/schedules/3" \
-H "Authorization: Bearer YOUR_API_KEY"
Responseโ
Success (204 No Content)โ
Returns no content on successful deletion.
Error Response (409 Conflict)โ
If the schedule has bookings:
{
"error": {
"code": "conflict",
"message": "This schedule has bookings and cannot be deleted."
}
}
Errorsโ
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 403 | insufficient_scope | API key lacks experiences:write scope |
| 404 | not_found | Experience or schedule not found |
| 409 | conflict | Schedule has existing bookings |
Notesโ
- Schedules with bookings cannot be deleted to preserve booking history
- If you need to prevent new bookings on a schedule, consider reducing the capacity instead
- This action is permanent and cannot be undone