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โ
| Parameter | Type | Required | Description |
|---|---|---|---|
source_week_start | string | Yes | Monday of the source week (YYYY-MM-DD) |
target_week_start | string | Yes | Monday of the target week (YYYY-MM-DD) |
include_staff | boolean | No | Copy staff assignments (default: true). Pass false to create open shifts. |
overwrite | boolean | No | Delete 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โ
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 401 | invalid_api_key | Invalid API key |
| 403 | insufficient_scope | API key lacks staff:write scope |
| 422 | validation_error | Missing 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
}'