---
title: "PUT Position"
method: PUT
path: "/positions/{id}"
---

# PUT Position

`PUT /positions/{id}`

## Request

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

/positions/:id
Permission level: 3

## Path parameters

- `id` integer, required

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

- object
  - `active` string: enum [1, -1] -> -1: Inactive; 1: Active
  - `job_code` string
  - `name` string
  - `start_time` string, date
  - `end_time` string, date
  - `color` integer
  - `location` integer
  - `visible` integer: enum [0, 1]
  - `skill_id` integer
  - `unique_id` string

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `name` string
    - `start_time` object
      - `id` integer
      - `time` string
    - `end_time` object
      - `id` integer
      - `time` string
    - `color` integer
    - `ical` string
    - `visible` integer
    - `notify` integer
    - `job_code` unknown
  - `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/positions/:id/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)
