Fenestro API Docs

Categories

Categories organize products and can point to a parent category from the same tenant.

Endpoints

MethodPathUse
POST/v1/categoriesCreate a category.
GET/v1/categoriesList 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

FieldRequiredNotes
nameyes2 to 200 characters.
descriptionnoMaximum 1000 characters.
parent_idnoMust be another category owned by the same tenant.
image_urlnoAbsolute URL.
display_ordernoNon-negative integer.