Skip to main content
The Kommit API is a REST API that lets you manage projects, nodes, edges, memory, and more programmatically.

Base URL

https://api.getkommit.ai
All endpoints are prefixed with /v1.

Authentication

Requests require either a session cookie (from the web app) or an API key passed as a Bearer token. See authentication for details.

Content type

All request and response bodies use JSON. Set Content-Type: application/json on requests with a body.

Pagination

List endpoints use cursor-based pagination:
cursor
string
Cursor from a previous response’s nextCursor field. Omit for the first page.
limit
number
default:"20"
Number of items per page. Min 1, max 100.
Paginated responses follow this shape:
{
  "data": [...],
  "nextCursor": "eyJpZCI6IjEyMyJ9"
}
When nextCursor is null, there are no more pages.

Error responses

Errors return a consistent JSON structure:
{
  "error": "Project not found",
  "code": "NOT_FOUND",
  "status": 404
}
Validation errors include field-level details:
{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "status": 400,
  "details": [
    { "field": "name", "message": "Required" }
  ]
}

Rate limiting

API key requests are limited to 1,000 requests per hour. The API returns 429 Too Many Requests when the limit is exceeded.