API Reference

GET/api/v1/version

Provides the version of the API.

POST/api/v1/token

Generates a JWT token for the provided AppId and Secret.

Tokens can be used by passing a "Authorization" header with a value using a "Bearer {token}" format alongside your request. Note that tokens are valid for 1 hour.

GET/api/v1/status

Get the current API user auth status.

This endpoint is used to check if the token is valid and to get the current user's identity. Please ensure you pass a "Authorization" header with a value using a "Bearer {token}" format.

GET/api/v1/collections

Gets a list of all collections in the database.

GET/api/v1/collections/{collectionId}

Gets a paginated list of all records in a collection.

POST/api/v1/collections/{collectionId}

Adds a new record to a collection.

GET/api/v1/collections/{collectionId}/all

Gets a chunked response of all the records in a collection.

GET/api/v1/collections/{collectionId}/{recordId}

Gets a single record from a collection.

PATCH/api/v1/collections/{collectionId}/{recordId}

Updates an existing record in a collection.

DELETE/api/v1/collections/{collectionId}/{recordId}

Deletes a single record from a collection.

PATCH/api/v1/collections/{collectionId}/{recordId}/stage

Changes a record stage

POST/api/v1/collections/{collectionId}/bulk

Bulk add new records to collection.

PATCH/api/v1/collections/{collectionId}/bulk

Updates existing records in a collection by their recordIds

DELETE/api/v1/collections/{collectionId}/bulk

Delete multiple records from a collection.

GET/api/v1/collections/{collectionId}/ext/{externalService}/{externalId}

Gets a single record from a collection by external service ID.

PATCH/api/v1/collections/{collectionId}/ext/{externalService}/{externalId}

Updates an existing record in a collection by external service ID.

DELETE/api/v1/collections/{collectionId}/ext/{externalService}/{externalId}

Deletes a single record from a collection by external service ID.

GET/api/v1/files/{id}

Downloads a file by id

GET/api/v1/activities/{collectionId}/{recordId}

Gets activities by collection and record IDs

POST/api/v1/activities/{collectionId}/{recordId}

Adds a new activity

GET/api/v1/colleagues

Gets a list of colleagues in your Kinabase tenant