Skip to main content

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โ€‹

ParameterTypeDescription
idintegerExperience ID
scheduleIdintegerSchedule 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โ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
403insufficient_scopeAPI key lacks experiences:write scope
404not_foundExperience or schedule not found
409conflictSchedule 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