API Reference

The Kemon API provides programmatic access to your workspace data. All endpoints are prefixed with /api/v1.

Authentication

curl -H "Authorization: Bearer your-api-key" \
  https://api.kemon.io/api/v1/tickets

Base URL

https://api.kemon.io/api/v1

Tickets

List Tickets

Returns a paginated list of tickets in the current workspace.

Query Parameters

Response

{
  "data": [
    {
      "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9B",
      "identifier": "KEM-42",
      "title": "Fix login redirect on mobile Safari",
      "description": "Users on iOS Safari are not redirected after OAuth login.",
      "status": "in_progress",
      "priority": "high",
      "assignee": {
        "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C",
        "name": "Jane Smith"
      },
      "labels": [{ "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9D", "name": "bug" }],
      "project_id": "01HQ3K5P7Y2XJMVR8N4W6TCA9E",
      "created_at": "2025-11-15T10:30:00Z",
      "updated_at": "2025-11-16T14:22:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 134,
    "total_pages": 6
  }
}

Get Ticket

Returns a single ticket by ID, including comments.

Response

{
  "data": {
    "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9B",
    "identifier": "KEM-42",
    "title": "Fix login redirect on mobile Safari",
    "description": "Users on iOS Safari are not redirected after OAuth login.",
    "status": "in_progress",
    "priority": "high",
    "assignee": {
      "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C",
      "name": "Jane Smith"
    },
    "labels": [{ "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9D", "name": "bug" }],
    "project_id": "01HQ3K5P7Y2XJMVR8N4W6TCA9E",
    "comments": [
      {
        "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9F",
        "body": "Reproduced on iOS 17.4. Investigating the callback URL.",
        "author": { "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C", "name": "Jane Smith" },
        "created_at": "2025-11-15T11:00:00Z"
      }
    ],
    "created_at": "2025-11-15T10:30:00Z",
    "updated_at": "2025-11-16T14:22:00Z"
  }
}

Create Ticket

Creates a new ticket.

Request Body

{
  "title": "Add dark mode to settings page",
  "description": "Users should be able to toggle dark mode from the settings panel.",
  "status": "open",
  "priority": "medium",
  "assignee_id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C",
  "label_ids": ["01HQ3K5P7Y2XJMVR8N4W6TCA9D"],
  "project_id": "01HQ3K5P7Y2XJMVR8N4W6TCA9E"
}

{
  "data": {
    "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9G",
    "identifier": "KEM-135",
    "title": "Add dark mode to settings page",
    "description": "Users should be able to toggle dark mode from the settings panel.",
    "status": "open",
    "priority": "medium",
    "assignee": {
      "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C",
      "name": "Jane Smith"
    },
    "labels": [{ "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9D", "name": "bug" }],
    "project_id": "01HQ3K5P7Y2XJMVR8N4W6TCA9E",
    "created_at": "2025-11-17T09:00:00Z",
    "updated_at": "2025-11-17T09:00:00Z"
  }
}

Update Ticket

Updates an existing ticket. Only include fields you want to change.

{
  "status": "done",
  "priority": "low"
}

{
  "data": {
    "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9B",
    "identifier": "KEM-42",
    "title": "Fix login redirect on mobile Safari",
    "status": "done",
    "priority": "low",
    "updated_at": "2025-11-18T16:45:00Z"
  }
}

Delete Ticket

Returns 204 No Content with no response body.

Projects

List Projects

Returns all projects in the workspace.

Query Parameters

Response

{
  "data": [
    {
      "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9E",
      "name": "Mobile App v2",
      "description": "Complete redesign of the mobile application.",
      "status": "active",
      "lead": {
        "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C",
        "name": "Jane Smith"
      },
      "ticket_count": 42,
      "created_at": "2025-10-01T08:00:00Z",
      "updated_at": "2025-11-16T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 8,
    "total_pages": 1
  }
}

Create Project

Creates a new project.

Request Body

{
  "name": "API v2 Migration",
  "description": "Migrate all endpoints from v1 to v2 schema.",
  "status": "active",
  "lead_id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C"
}

{
  "data": {
    "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9H",
    "name": "API v2 Migration",
    "description": "Migrate all endpoints from v1 to v2 schema.",
    "status": "active",
    "lead": {
      "id": "01HQ3K5P7Y2XJMVR8N4W6TCA9C",
      "name": "Jane Smith"
    },
    "ticket_count": 0,
    "created_at": "2025-11-17T09:30:00Z",
    "updated_at": "2025-11-17T09:30:00Z"
  }
}

Rate Limiting

API requests are rate-limited per API key:

Error Codes

Standard HTTP status codes are used. Error responses follow a consistent format:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested ticket could not be found.",
    "status": 404
  }
}