---
title: "POST Swap"
method: POST
path: "/shifts/{shift}/swap"
---

# POST Swap

`POST /shifts/{shift}/swap`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/shifts/{shift}/swap`
- Auth: API key in query parameter `access_token`

/shifts/:shift/swap
Permission level: 5

## Path parameters

- `shift` integer, required

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

- object
  - `swap` string, required: Array of user_shift_id's (eg. "1435,5667") , you get user_shift_id with schedule.tradelist and swap bit set to 1
  - `reason` string, required

## Response `200`

200

- object
  - `status` integer
  - `data` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/shifts/:shift/swap/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)
