---
title: "PUT Employee position"
method: PUT
path: "/employees/{employee_id}/positions/{position_id}"
---

# PUT Employee position

`PUT /employees/{employee_id}/positions/{position_id}`

## Request

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

/employees/:employee_id/positions/:position_id
Permission level: 3

## Path parameters

- `employee_id` integer, required
- `position_id` integer, required

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

- object
  - `payroll_ratecard_id` integer: Note: deprecated, use "ratecard" parameter instead
  - `payroll_wage` string: Note: deprecated, use "wage" parameter instead
  - `wage` number, float: Updates a wage for an Employee Position. Associated Rate Card will not be changed.

## Response `200`

200

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/employees/:employee_id/positions/:position_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)
