Catalog
Catálogo de productos y servicios
GET/api/ai-agents/{id}/catalog-items
Lista los ítems de catálogo del agente
Ámbito requerido: catalog.read
| Parámetro | Dónde | Obligatorio |
|---|---|---|
id | path | sí |
bash
curl "https://api.zapyflow.com.br/api/ai-agents/{id}/catalog-items" \
-H "Authorization: Bearer $ZAPYFLOW_API_KEY"Respuestas
200— OK404— No encontrado — también es la respuesta cuando el recurso es de otro workspace
POST/api/ai-agents/{id}/catalog-items
Crea un ítem de catálogo
Ámbito requerido: catalog.write
| Parámetro | Dónde | Obligatorio |
|---|---|---|
id | path | sí |
Cuerpo de la petición
| Campo | Tipo | Obligatorio | Restricciones |
|---|---|---|---|
name | string | sí | min 1, max 150 |
description | string | no | max 1000 |
price | number | sí | ≥ 0 |
imageUrl | object | string | null | no | — |
category | object | string | null | no | — |
active | boolean | no | — |
order | integer | no | — |
bash
curl -X POST "https://api.zapyflow.com.br/api/ai-agents/{id}/catalog-items" \
-H "Authorization: Bearer $ZAPYFLOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{ ... }'Respuestas
201— Creado404— No encontrado — también es la respuesta cuando el recurso es de otro workspace
PATCH/api/ai-agents/{id}/catalog-items/{itemId}
Edita un ítem de catálogo
Ámbito requerido: catalog.write
| Parámetro | Dónde | Obligatorio |
|---|---|---|
id | path | sí |
itemId | path | sí |
Cuerpo de la petición
| Campo | Tipo | Obligatorio | Restricciones |
|---|---|---|---|
name | string | no | min 1, max 150 |
description | string | no | max 1000 |
price | number | no | ≥ 0 |
imageUrl | object | string | null | no | — |
category | object | string | null | no | — |
active | boolean | no | — |
order | integer | no | — |
bash
curl -X PATCH "https://api.zapyflow.com.br/api/ai-agents/{id}/catalog-items/{itemId}" \
-H "Authorization: Bearer $ZAPYFLOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{ ... }'Respuestas
200— OK404— No encontrado — también es la respuesta cuando el recurso es de otro workspace
DELETE/api/ai-agents/{id}/catalog-items/{itemId}
Elimina un ítem de catálogo sin tocar el recurso externo del proveedor
Ámbito requerido: catalog.write
| Parámetro | Dónde | Obligatorio |
|---|---|---|
id | path | sí |
itemId | path | sí |
bash
curl -X DELETE "https://api.zapyflow.com.br/api/ai-agents/{id}/catalog-items/{itemId}" \
-H "Authorization: Bearer $ZAPYFLOW_API_KEY"Respuestas
204— CatalogItem removido com sucesso404— No encontrado — también es la respuesta cuando el recurso es de otro workspace