Categories

Categories group jobs on your board. You can list them, create them, and assign a category when creating a job, all by name (no need to track UUIDs).

Authenticate with your API key in the x-api-key header.

GET https://api.kardow.com/categories

cURL

curl --url "https://api.kardow.com/categories" \
  --header "x-api-key: your-api-key-here"

{
  "data": [
    { "id": "1f2e...", "name": "Engineering", "slug": "engineering" },
    { "id": "9a7c...", "name": "Design", "slug": "design" }
  ]
}

Create a category

Creating is idempotent: if a category with that name already exists, its id is returned instead of a duplicate.

POST https://api.kardow.com/categories

string

required

Category name, e.g. Engineering.

cURL

curl --request POST \
  --url "https://api.kardow.com/categories" \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{ "name": "Engineering" }'

Assigning a category to a job

When creating a job with Create Job, pass either:

category — a category name. It is matched to an existing category (case-insensitive) or created if new.
category_id — an existing category UUID (takes precedence over category).

cURL

curl --request POST \
  --url "https://api.kardow.com/jobs" \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{
    "title": "Senior Engineer",
    "description": "...",
    "company_name": "Acme",
    "category": "Engineering"
  }'

Getting Started

Analytics

Jobs

Applications

Content

Members

Users

Webhooks

Secrets

CMS

Create a category

Assigning a category to a job

​List categories

​Create a category

​Assigning a category to a job

List categories

Create a category

Assigning a category to a job