Categories
Categories organize products and can point to a parent category from the same tenant.
Endpoints
| Method | Path | Use |
|---|
| POST | /v1/categories | Create a category. |
| GET | /v1/categories | List categories. Supports parent_id. |
| GET | /v1/categories/{id} | Read one category. |
| PATCH | /v1/categories/{id} | Update provided fields. |
| DELETE | /v1/categories/{id} | Deactivate the category. |
Create example
curl -X POST https://api.fenestro.io/v1/categories \
-H "Authorization: Bearer fen_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"name":"Windows","description":"Window products","display_order":1}'
Fields
| Field | Required | Notes |
|---|
name | yes | 2 to 200 characters. |
description | no | Maximum 1000 characters. |
parent_id | no | Must be another category owned by the same tenant. |
image_url | no | Absolute URL. |
display_order | no | Non-negative integer. |