Skip to main content

Mark People Back

Record who has come back from a departure. A person must be checked in on the departure, and the departure must have started, before they can be marked back. This is the Back button staff press on Today, the session's manifest and the mobile app.

  • Mark one person back, undo it, mark everyone on one booking back (people not named yet included), or mark everyone still out on the departure back.
  • When the last person out is marked back, the departure is completed, as Complete Schedule does.
  • A booking that runs on several days is counted day by day: each departure has its own Back.

Endpointsโ€‹

POST   /v1/experiences/{id}/schedules/{scheduleId}/participants/{participantId}/back
DELETE /v1/experiences/{id}/schedules/{scheduleId}/participants/{participantId}/back
POST /v1/experiences/{id}/schedules/{scheduleId}/bookings/{bookingId}/back
POST /v1/experiences/{id}/schedules/{scheduleId}/back

DELETE undoes one person's Back: they read as still out again. It works on someone a member of staff marked back. Once the departure was finished by Complete or at its end time, everyone on it stays back and DELETE answers 422.

Authenticationโ€‹

Requires an API key with the bookings:write scope.

Path Parametersโ€‹

ParameterTypeDescription
idintegerExperience ID
scheduleIdintegerSchedule (departure) ID
participantIdintegerparticipants[].id from Get Departure Manifest
bookingIdintegerA booking on this departure

Example Requestโ€‹

curl -X POST "https://app.equipdash.com/api/v1/experiences/12/schedules/487/participants/501/back" \
-H "Authorization: Bearer YOUR_API_KEY"

Responseโ€‹

Success (200 OK)โ€‹

{
"data": {
"schedule_id": 487,
"message": "Amy Chen is back.",
"session_finished": false,
"checked_in_count": 4,
"back_count": 1,
"out_count": 3
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-10-09T15:42:00+00:00"
}
}

out_count is people checked in on the departure and not marked back yet. It never counts anyone who did not check in. session_finished is true when this call marked the last person back.

Errorsโ€‹

StatusCodeWhen
403forbiddenThe experience belongs to another business
404resource_not_foundNo such experience, or the schedule is not one of its departures
422not_on_sessionThe person is not on this departure
422not_marked_backNothing changed: not checked in yet, the departure has not started, already back, nobody out, or (for DELETE) the departure was finished by Complete or at its end time