Runn

Runn Projects API

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

GitHub OpenAPI
Business capability
Project Management BC-900.30

Operations 44

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 #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/runn/openapi/runn-projects-api-openapi.yml

Schemas & Data

📊
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/runn:runn-projects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

runn-projects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Runn Projects API
  version: 1.0.0
  description: 'See the full documentation and guide to using the Runn API.


    The domain for your API endpoint can be found in Accounts > Settings > API in your Runn application'
servers:
- url: https://api.runn.io
  description: EU Server
- url: https://api.us.runn.io
  description: US Server
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (103 KB total) ---
# Full source: https://artifacts.apis.io/runn/openapi/runn-projects-api-openapi.yml