Developer Documentation
Endpoints
Records
Base URL: https://app.kinabase.com/api/v1/
get
collections/{collectionId}
Gets a paginated list of all records in a collection.Parameters
| Name | Location | Type | Description |
|---|---|---|---|
| collectionId * | path | string | Collection ID or Slug |
| pageIndex | query | integer | Page index to return |
| pageSize | query | integer | Number of records to return (default: 10, max: 300) |
| updatedAfter | query | string | Only return records updated after this time (ISO8601 format) |
| externalService | query | string | Only fetch records linked to a specified external service (externalService=true for match any service) |
Response
| Status | Description | Content |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 401 | Unauthorized | |
| 404 | Not Found |
post
collections/{collectionId}
Adds a new record to a collection.Parameters
| Name | Location | Type | Description |
|---|---|---|---|
| collectionId * | path | string | Collection ID or Slug |
Request Body
Record Json
Example request (application/json):
{
"id": null,
"numericId": null,
"data": {
"example-key": {}
},
"external": null
}get
collections/{collectionId}/all
Gets a chunked response of all the records in a collection.Parameters
| Name | Location | Type | Description |
|---|---|---|---|
| collectionId * | path | string | Collection ID or Slug |
| updatedAfter | query | string | Only return records updated after this time (ISO8601 format) |
| externalService | query | string | Only fetch records linked to a specified external service (externalService=true for match any service) |
get
patch
collections/{collectionId}/{recordId}
Updates an existing record in a collection.Parameters
| Name | Location | Type | Description |
|---|---|---|---|
| collectionId * | path | string | Collection ID or Slug |
| recordId * | path | string | Record ID to update |
Request Body
Record JSON
Example request (application/json):
{
"id": null,
"numericId": null,
"data": {
"example-key": {}
},
"external": null
}delete
patch
collections/{collectionId}/{recordId}/stage
Changes a record stageParameters
| Name | Location | Type | Description |
|---|---|---|---|
| collectionId * | path | string | Collection ID or Slug |
| recordId * | path | string | Record ID to update |
Request Body
Object containing StageId
Example request (application/json):
{
"stageId": "example-stageId"
}