> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eachlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Categories

> Retrieve all available workflow categories.

## Endpoint

```
GET https://workflows.eachlabs.run/api/v1/categories
```

<Warning>
  This public URL uses a deprecated compatibility host outside the api-service host. It remains supported for now, but will soon move under `https://api.eachlabs.ai`. Keep integrations configurable and switch to the api-service URL once it is published.
</Warning>

## Code Examples

<CodeGroup>
  ```bash cURL theme={"dark"}
  curl https://workflows.eachlabs.run/api/v1/categories \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```python Python theme={"dark"}
  import requests

  response = requests.get(
      "https://workflows.eachlabs.run/api/v1/categories",
      headers={"X-API-Key": "YOUR_API_KEY"}
  )

  for cat in response.json()["categories"]:
      print(f"{cat['slug']}: {cat['label']}")
  ```

  ```javascript JavaScript theme={"dark"}
  const response = await fetch(
    "https://workflows.eachlabs.run/api/v1/categories",
    { headers: { "X-API-Key": "YOUR_API_KEY" } }
  );
  const { categories } = await response.json();
  categories.forEach((c) => console.log(`${c.slug}: ${c.label}`));
  ```
</CodeGroup>

## Response

```json theme={"dark"}
{
  "categories": [
    {
      "slug": "image-generation",
      "label": "Image Generation",
      "description": "Workflows for generating images",
      "is_default": true,
      "created_at": "2025-12-01T10:00:00Z",
      "updated_at": "2025-12-01T10:00:00Z"
    },
    {
      "slug": "text-processing",
      "label": "Text Processing",
      "description": "Workflows for processing text",
      "is_default": true,
      "created_at": "2025-12-01T10:00:00Z",
      "updated_at": "2025-12-01T10:00:00Z"
    }
  ]
}
```

### Category Fields

| Field         | Type    | Description                             |
| ------------- | ------- | --------------------------------------- |
| `slug`        | string  | Unique identifier (use in API requests) |
| `label`       | string  | Human-readable name                     |
| `description` | string  | Category description                    |
| `is_default`  | boolean | Whether it's a system default category  |
| `created_at`  | string  | ISO 8601 creation timestamp             |
| `updated_at`  | string  | ISO 8601 update timestamp               |