---
title: "Record pay or title changes"
method: POST
path: "/team/changes"
tags: ["team"]
---

# Record pay or title changes

`POST /team/changes`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/team/changes`
- Auth: HTTP bearer

Records a pay, title or options change for one or more people on Team (up to 100), each from its effective date. With letter_template_id, each person's letter fills from the company's confirmed change template, is checked word for word and waits as a draft envelope (the officer signs first, the person second with an emailed code, signing or acknowledging as the template says) until team.change.send. One payroll task covers the call; new options open a task for the board's grant. Pay is typed, never suggested, and only members who see pay record it.

## Request body

- object
  - `changes` object[], required
    - `party_id` string, required
    - `effective_on` string, date, required
    - `title` string
    - `pay` object
      - `amount` string, required
      - `currency` string, required
      - `period` 'year' | 'hour', required
    - `options` integer
    - `note` string
  - `letter_template_id` string, nullable

## Response `200`

The result.

- object
  - `changes` object[], required
    - `id` string, required
    - `party_id` string, required
    - `name` string, required
    - `effective_on` string, date, required
    - `envelope_id` string, nullable, required
    - `exceptions` object[], required
      - `kind` 'pay_cut', required
      - `text` string, required
  - `task_id` string, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)