---
title: "POST Copy"
method: POST
path: "/copy"
---

# POST Copy

`POST /copy`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/copy`
- Auth: API key in query parameter `access_token`

/copy
Permission level: 5

## Request body `application/x-www-form-urlencoded`

- object
  - `from_start` string, date, required
  - `from_end` string, date, required
  - `to_start` string, date, required
  - `to_end` string, date, required
  - `schedule` string: Array of employees ids (eg. "234,563,770")
  - `location` string: Array of locations ids (eg. "234,563,770")
  - `mode` string: enum[manage,requested,upcoming]
  - `with_staf` integer: enum[0,1] 0: Copy staff, 1: Do not copy staff
  - `filter_by_site` string
  - `filter_by_employee` string
  - `filter_by_skill` string
  - `filter_by_shift_type` string

## Response `200`

200

- object
  - `status` integer
  - `data` string
  - `token` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/copy/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
