Skip to main content

​
POST /api/v1/sub-categories

Create a sub-category under a parent category.

​
Request Body

FieldTypeRequiredDescription
categoryIdstringYesParent category ID
namestringYesSub-category name
descriptionstringNoOptional description
statusstringNo"active" (default), "paused", "archived"

​
Example

curl -X POST https://playground.kaireonai.com/api/v1/sub-categories \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "categoryId": "cat_credit_cards",
    "name": "Premium Cards",
    "description": "High-tier credit card products",
    "status": "active"
  }'

​
GET /api/v1/sub-categories

List all sub-categories for the tenant. Optionally filter by parent category.

​
Query Parameters

ParameterTypeDescription
categoryIdstringFilter by parent category ID

​
PUT /api/v1/sub-categories

Update a sub-category.

​
DELETE /api/v1/sub-categories

Delete a sub-category by ID.