Skip to main content

Save Schedule Template

Snapshot a week's shifts into a named reusable template.

Endpointโ€‹

POST /v1/staff/schedule/templates

Authenticationโ€‹

Requires an API key with the staff:write scope.

Request Bodyโ€‹

ParameterTypeRequiredDescription
week_startstringYesMonday of the week to snapshot (YYYY-MM-DD)
namestringYesTemplate name (max 255 characters)

Responseโ€‹

Success (201 Created)โ€‹

{
"data": {
"id": 3,
"name": "Easter Weekend",
"shift_count": 10,
"created_at": "2026-04-01T09:00:00+00:00",
"updated_at": "2026-04-01T09:00:00+00:00"
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-04-01T09:00:00+00:00"
}
}

Errorsโ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
401invalid_api_keyInvalid API key
403insufficient_scopeAPI key lacks staff:write scope
422validation_errorMissing or invalid fields

Example Requestโ€‹

curl -X POST "https://app.equipdash.com/api/v1/staff/schedule/templates" \
-H "Authorization: Bearer eqd_live_abc123xyz789..." \
-H "Content-Type: application/json" \
-d '{
"week_start": "2026-03-30",
"name": "Easter Weekend"
}'