# People

Endpoints related to managing people records.

## List all people

 - [GET /people/v2](https://developers.calamari.dev/remote/calamari-public-openapi/people/listallpeople.md): You can fetch a list of all people.
You can optionally specify a limit to control the number of results returned, and an offset to skip a specified number of entries from the start.

## Create a new person

 - [POST /people/v2](https://developers.calamari.dev/remote/calamari-public-openapi/people/createperson.md): This endpoint allows you to add a new person to the Calamari.
The request must include essential details such as first name, last name,
e-mail address, approval process, work schedule, and holidays calendar.

## Update a person

 - [PATCH /people/v2/{id}](https://developers.calamari.dev/remote/calamari-public-openapi/people/partialupdateperson.md): This endpoint allows you to partially update a person in Calamari.
You can send any number of fields in the request body.
Only the fields included in the request will be updated.
If a field is set to null, its value will be removed (if removal is allowed).
Fields that are not included in the request will remain unchanged, even if they exist in the system.
This means you can send both updated and unchanged fields, but only those explicitly provided in the request will be processed.

## Archive a person

 - [POST /people/v2/{id}/archive](https://developers.calamari.dev/remote/calamari-public-openapi/people/archiveperson.md): This endpoint allows you to archive a person in Calamari.

## Invite a person

 - [POST /people/v2/{id}/invite](https://developers.calamari.dev/remote/calamari-public-openapi/people/inviteperson.md): This endpoint allows you to send an invitation email to Calamari.