---
title: "PUT Trade"
method: PUT
path: "/trades/{trade}"
---

# PUT Trade

`PUT /trades/{trade}`

## Request

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

/trades/:trade
Permission level: 5

## Path parameters

- `trade` integer, required

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

- object
  - `action` string, required: enum[activate,deactivade,cancel,accept,reject]
  - `user` integer

## Response `200`

200

- object
  - `status` string
  - `data` object
    - `id` string
    - `status` string
    - `user` string
    - `shift` string
    - `store` string
    - `reference` string
    - `reason` string
    - `date` string
    - `confirm_before` string
    - `confirm_after` string
    - `trade_to` string
    - `shift_start_date` object
      - `id` string
      - `month` string
      - `day` string
      - `year` string
      - `weekday` string
      - `mname` string
      - `week` string
      - `dayid` string
      - `formatted` string
    - `shift_start` string
    - `shift_end` string
    - `shift_schedule` string
    - `schedule_name` string
    - `user_name` string
    - `requested` object
      - `id` string
      - `month` string
      - `day` string
      - `year` string
      - `weekday` string
      - `mname` string
      - `week` string
      - `dayid` string
      - `formatted` string
    - `shift_start_time` string
    - `shift_end_time` string
    - `traders` object
      - `count` string
      - `data` object[]
        - `id` string
        - `trade_id` string
        - `shift` string
        - `user` string
        - `confirmed` string
        - `approved` string
        - `sms` string
        - `email` string
        - `online` string
        - `user_name` 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/trades/:trade/put.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)
