# Runn Projects API

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

Runn Projects 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 Project. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Projects API from Runn — 27 operation(s) for projects.

## Operations (44)

| Method | Path | Summary |
|---|---|---|
| GET | `/projects/{projectId}` | Show a project |
| PATCH | `/projects/{projectId}` | Update a project |
| GET | `/projects/` | List projects |
| POST | `/projects/` | Create a project |
| GET | `/projects/custom-fields` | List project custom fields |
| DELETE | `/projects/{projectId}/` | Delete a project |
| GET | `/projects/{projectId}/actuals/` | List actuals for a project |
| GET | `/projects/{projectId}/assignments/` | List assignments for a project |
| GET | `/projects/{projectId}/budget-roles/{roleId}` | Get a project budget role |
| PATCH | `/projects/{projectId}/budget-roles/{roleId}` | Update a project budget role |
| DELETE | `/projects/{projectId}/budget-roles/{roleId}` | Delete a project budget role |
| GET | `/projects/{projectId}/budget-roles/` | Get a paginated list of project budget roles for a project |
| POST | `/projects/{projectId}/budget-roles/` | Create a project budget role |
| PATCH | `/projects/{projectId}/custom-fields/checkbox/` | Add a checkbox custom value to a project |
| PATCH | `/projects/{projectId}/custom-fields/date/` | Add a date custom field value to a project |
| PATCH | `/projects/{projectId}/custom-fields/select/` | Add a select custom field to a project |
| PATCH | `/projects/{projectId}/custom-fields/text/` | Add a text custom field value to a project |
| POST | `/projects/{projectId}/milestones/` | Create a milestone for a project |
| GET | `/projects/{projectId}/milestones/` | List milestones for a project |
| DELETE | `/projects/{projectId}/milestones/{milestoneId}` | Delete a milestone for a project |
| PATCH | `/projects/{projectId}/milestones/{milestoneId}` | Update a milestone for a project |
| POST | `/projects/{projectId}/notes/` | Create a project note |
| GET | `/projects/{projectId}/notes/` | List notes for a project |
| GET | `/projects/{projectId}/other-expenses/` | List other expenses for a project |
| POST | `/projects/{projectId}/other-expenses/` | Create an other expense for a project |
| PATCH | `/projects/{projectId}/other-expenses/{otherExpenseId}/` | Update an other expense on a project |
| GET | `/projects/{projectId}/people/` | List people assigned to a project |
| GET | `/projects/{projectId}/person-requests/` | List the person requests for a project |
| POST | `/projects/{projectId}/person-requests/` | Create a person request on a project |
| GET | `/projects/{projectId}/person-requests/{personRequestId}` | Show a single person request for a project |
| PATCH | `/projects/{projectId}/person-requests/{personRequestId}` | Update the status of a person request on a project |
| GET | `/projects/{projectId}/phases/` | List phases for a project |
| POST | `/projects/{projectId}/phases/` | Create a phase for a project |
| GET | `/projects/{projectId}/phases/{phaseId}` | Show a phase for a project |
| PATCH | `/projects/{projectId}/phases/{phaseId}` | Update a phase for a project |
| DELETE | `/projects/{projectId}/phases/{phaseId}` | Delete a phase for a project |
| GET | `/projects/{projectId}/project-rates/` | List role rates for a project |
| PATCH | `/projects/{projectId}/project-rates/{projectRateId}/` | Update a rate for a role on a project |
| GET | `/projects/{projectId}/project-workstreams/` | List workstreams assigned to a project |
| GET | `/projects/{projectId}/project-workstreams/{workstreamId}/` | View project workstream |
| POST | `/projects/{projectId}/project-workstreams/{workstreamId}/` | Add a workstream to a project |
| DELETE | `/projects/{projectId}/project-workstreams/{workstreamId}/` | Delete project workstream |
| GET | `/projects/{projectId}/timesheet-lock/` | Show a timesheet lock for a project |
| PATCH | `/projects/{projectId}/timesheet-lock/` | Update a timesheet lock for a project |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/runn/openapi/runn-projects-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

Project

---

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