---
title: "Change a person's record on Team"
method: PATCH
path: "/team/{party_id}"
tags: ["team"]
---

# Change a person's record on Team

`PATCH /team/{party_id}`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/team/{party_id}`
- Auth: HTTP bearer

Changes the title, start date or work state on a person's current employment, as a member recorded them. Pay and dated changes are recorded with team.change.record.

## Path parameters

- `party_id` string, required

## Request body

- object
  - `title` string
  - `start_date` string, date, nullable
  - `work_state` string, nullable

## Response `200`

The result.

- object
  - `party_id` string, nullable, required
  - `member_id` string, nullable, required
  - `name` string, required
  - `email` string, nullable, required
  - `kind` 'employee' | 'founder' | 'contractor', required
  - `title` string, required
  - `start_date` string, date, nullable, required
  - `work_state` string, nullable, required
  - `ended_on` string, date, nullable, required
  - `ended_by` 'resigned' | 'company', nullable, required
  - `source` 'application.hired' | 'added' | 'imported' | 'workspace', required
  - `agreement` object, required
    - `state` 'signed' | 'sent' | 'uploaded' | 'none' | 'not_needed', required
    - `on` string, date, nullable, required
  - `ip` object, required
    - `state` 'signed' | 'sent' | 'uploaded' | 'none' | 'not_needed', required
    - `on` string, date, nullable, required
  - `departure` object, nullable, required
    - `id` string, required
    - `last_day` string, date, required
    - `ended_by` 'resigned' | 'company', required
    - `private` boolean, required
    - `letter` 'signed' | 'sent' | 'draft' | 'none', required
  - `last_change` object, nullable, required
    - `id` string, required
    - `effective_on` string, date, required
    - `letter` 'signed' | 'sent' | 'draft' | 'none', 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)