Skip to main content

Copy Week

Copy all shifts from one week to another. Optionally carry over staff assignments and optionally overwrite any shifts that already exist in the target week.

Endpointโ€‹

POST /v1/staff/schedule/copy-week

Authenticationโ€‹

Requires an API key with the staff:write scope.

Request Bodyโ€‹

ParameterTypeRequiredDescription
source_week_startstringYesMonday of the source week (YYYY-MM-DD)
target_week_startstringYesMonday of the target week (YYYY-MM-DD)
include_staffbooleanNoCopy staff assignments (default: true). Pass false to create open shifts.
overwritebooleanNoDelete existing shifts in the target week before copying (default: false)

Responseโ€‹

Success (200 OK)โ€‹

{
"data": {
"copied_count": 12,
"skipped_count": 0
},
"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 date fields

Example Requestโ€‹

curl -X POST "https://app.equipdash.com/api/v1/staff/schedule/copy-week" \
-H "Authorization: Bearer eqd_live_abc123xyz789..." \
-H "Content-Type: application/json" \
-d '{
"source_week_start": "2026-03-30",
"target_week_start": "2026-04-06",
"include_staff": true,
"overwrite": false
}'