Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Capmo Project People API

The Project People API from Capmo — 3 operation(s) for project people.

Capmo Project People API is one of 23 APIs that Capmo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Project People. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 3 paths, and defines 5 schemas. It is described by OpenAPI 3.0.0, at version 1.0.

Requests are made against a single base URL, https://api.capmo.de.

6 operations 3 paths 5 schemas 1 DELETE2 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0
Base URL
https://api.capmo.de/api/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Capmo Project People API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (CapmoAuth).

  • CapmoAuth — For authentication, use the custom prefix followed by a space and then your API key. Example: "Capmo YOURAPIKEY".

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Project People 6
GET
/api/v1/projects/{projectId}/people
This can be used to list all project contact book people in a paginated response.
getProjectPeople 6 params → 200400401403404409500
POST
/api/v1/projects/{projectId}/people
This can be used to add a new project contact book person.
createProjectPerson 2 params body → 201400401403404409500
GET
/api/v1/projects/{projectId}/people/{personId}
This can be used to retrieve a specific project person by its ID.
getProjectPerson 3 params → 200400401403404409500
PATCH
/api/v1/projects/{projectId}/people/{personId}
This can be used to update a project contact book person.
updateProjectPerson 3 params body → 201400401403404409500
DELETE
/api/v1/projects/{projectId}/people/{personId}
This can be used to delete a project contact book person. If the person is a member of the project, their membership will be deleted as well.
deleteProjectPerson 3 params → 200400401403404409500
POST
/api/v1/projects/{projectId}/people-from-organisation
This can be used to add an organisation contact book person to a project.
createProjectPersonFromOrganisation 2 params body → 201400401403404409500

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are ReadProjectPersonDto (18 properties), CreateProjectPersonDto (7 properties), UpdateProjectPersonDto (7 properties), PaginatedOutputDto (3 properties). Each schema is shown below with its type and property counts.

ReadProjectPersonDto
object
18 properties 17 required
PaginatedOutputDto
object
3 properties 3 required
CreatePersonFromOrganisationDto
object
1 property 1 required
UpdateProjectPersonDto
object
7 properties
CreateProjectPersonDto
object
7 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

capmo-project-people-api-openapi.yml Raw ↑

Other APIs Capmo publishes across the network.

Capmo Organisation Companies API
Capmo Organisation Memberships API
Capmo Organisation People API
Capmo Organisation Projects API
Capmo Other API
Capmo Project Change Orders API
Capmo Project Companies API
Capmo Project Documents API
Capmo Project Memberships API
Capmo Project Permission Sets API
Capmo Project Plans API
Capmo Project Room Listings API