Projects

Download the specification

Retrieve a project by ID

get

Required scopes

This endpoint requires the following scopes:

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstring · uuidRequired

Project identifier

Responses

200

The project

application/json

get

/projects/{projectId}

HTTPcURLJavaScriptPython

GET /projects/{projectId} HTTP/1.1
Host: api.kpnthings.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

The project

No content

Retrieve projects, filtered by search term and / or client ID

get

Retrieve all projects that match the query parameters given. If a search parameter is provided, projects whose name or description (partially) match are returned.

Required scopes

This endpoint requires the following scopes:

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cursorstring · cursorOptional

String that encodes all necessary information to retrieve a page.

limitintegerOptional

Limit the number of results (per page).

Default: 50

sortstringOptional

Sorting fields separated by comma. Default order is Ascending (ASC), minus(-) should be used in front of field name for Descending (DESC) order.

Example: createdAt,-name

qstring · min: 1Optional

Include only projects whose name or description contain the search term. Matching is done case-insensitively.

clientIdstring · uuidOptional

Include only projects owned by the client matching clientId.

createdBeforestring · date-timeOptional

Include only projects created before the provided date and time. The date-time must be in ISO 8601 format.

createdSincestring · date-timeOptional

Include only projects created at or after the provided date and time. The date-time must be in ISO 8601 format.

modifiedBeforestring · date-timeOptional

Include only projects modified before the provided date and time. The date-time must be in ISO 8601 format.

modifiedSincestring · date-timeOptional

Include only projects modified at or after the provided date and time. The date-time must be in ISO 8601 format.

Responses

200

Page of filtered projects. Only projects that are accessible to the caller are returned.

application/json

Responseall of

A paginated list of projects

and

400

Request is missing required information or invalid

application/problem+json

get

/projects

HTTPcURLJavaScriptPython

GET /projects HTTP/1.1
Host: api.kpnthings.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content