# Runn People API

**Canonical:** https://apis.io/apis/runn/runn-people-api/  
**Provider:** Runn — https://apis.io/providers/runn/  
**Base URL:** https://api.runn.io  
**Documentation:** https://developer.runn.io/docs/getting-started.md

Runn People API is one of 33 APIs that [Runn](https://apis.io/providers/runn/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include People. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The People API from Runn — 24 operation(s) for people.

## Operations (32)

| Method | Path | Summary |
|---|---|---|
| GET | `/people/{personId}` | Show a person or placeholder |
| PATCH | `/people/{personId}` | Update a person or placeholder |
| DELETE | `/people/{personId}` | Delete a person or placeholder |
| GET | `/people/` | List people |
| POST | `/people/` | Create a person |
| GET | `/people/skills` | List people skills |
| GET | `/people/notes` | List people notes |
| GET | `/people/contracts/current` | List people current contracts |
| GET | `/people/custom-fields` | List people custom fields |
| GET | `/people/{personId}/actuals/` | List actuals for a person |
| GET | `/people/{personId}/assignments/` | List assignments for a person or placeholder |
| GET | `/people/{personId}/contracts/` | List contracts for a person |
| POST | `/people/{personId}/contracts/` | Add a new contract to a person |
| GET | `/people/{personId}/contracts/current` | Show current contract for a person |
| DELETE | `/people/{personId}/contracts/{contractId}` | Delete a contract for a person |
| PATCH | `/people/{personId}/contracts/{contractId}` | Update a contract for a person |
| PATCH | `/people/{personId}/custom-fields/checkbox/` | Add a checkbox custom value to a person or placeholder |
| PATCH | `/people/{personId}/custom-fields/date/` | Add a date custom value to a person or placeholder |
| PATCH | `/people/{personId}/custom-fields/select/` | Add custom select options to a person or placeholder |
| PATCH | `/people/{personId}/custom-fields/text/` | Add a text custom value to a person or placeholder |
| GET | `/people/{personId}/projects/` | List projects for a person or placeholder |
| POST | `/people/{personId}/projects/` | Add project to a person or placeholder |
| GET | `/people/{personId}/skills/` | List skills for a person or placeholder |
| POST | `/people/{personId}/skills/` | Add a skill to a person or placeholder |
| PATCH | `/people/{personId}/skills/{skillId}` | Update a skill for a person or placeholder |
| DELETE | `/people/{personId}/skills/{skillId}` | Remove a skill from a person or placeholder |
| GET | `/people/{personId}/teams/current` | Show current team for a person or placeholder |
| POST | `/people/{personId}/teams/` | Add a person or placeholder to a team |
| DELETE | `/people/{personId}/teams/{teamId}` | Remove a person or placeholder from a team |
| GET | `/people/{personId}/time-offs/leave` | List leave for a person |
| GET | `/people/{personId}/time-offs/holidays` | List holidays for a person |
| GET | `/people/{personId}/time-offs/rostered-off` | List rostered time offs for a person |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/runn/openapi/runn-people-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/runn/json-schema/runn-person-schema.json
- **JSONSchema** — https://artifacts.apis.io/runn/json-schema/runn-project-schema.json
- **JSONSchema** — https://artifacts.apis.io/runn/json-schema/runn-invitation-schema.json
- **JSONSchema** — https://artifacts.apis.io/runn/json-schema/runn-reports-hours-people-schema.json
- **JSONSchema** — https://artifacts.apis.io/runn/json-schema/runn-reports-hours-projects-schema.json
- **JSONSchema** — https://artifacts.apis.io/runn/json-schema/runn-actual-time-entry-schema.json

## Other Runn APIs (12)

- [Runn Activity Log API](https://apis.io/apis/runn/runn-activity-log-api/)
- [Runn Actuals API](https://apis.io/apis/runn/runn-actuals-api/)
- [Runn Assignments API](https://apis.io/apis/runn/runn-assignments-api/)
- [Runn Budget Roles API](https://apis.io/apis/runn/runn-budget-roles-api/)
- [Runn Clients API](https://apis.io/apis/runn/runn-clients-api/)
- [Runn Contracts API](https://apis.io/apis/runn/runn-contracts-api/)
- [Runn Custom Fields API](https://apis.io/apis/runn/runn-custom-fields-api/)
- [Runn Holiday Groups API](https://apis.io/apis/runn/runn-holiday-groups-api/)
- [Runn Invitations API](https://apis.io/apis/runn/runn-invitations-api/)
- [Runn Legacy Id API](https://apis.io/apis/runn/runn-legacy-id-api/)
- [Runn Me API](https://apis.io/apis/runn/runn-me-api/)
- [Runn Milestones API](https://apis.io/apis/runn/runn-milestones-api/)

## Tags

People

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/runn/runn-people-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/runn/.