Carpetas
Organizar flujos en carpetas
Las carpetas agrupan flujos. Se asigna un flujo a una carpeta con folderId al crearlo o actualizarlo.
Objeto Folder
{
"id": "b7f2c3e1-0000-0000-0000-000000000000",
"organizationId": "c2d1f0aa-0000-0000-0000-000000000000",
"parentId": null,
"name": "Ventas",
"description": "Flujos del equipo comercial",
"flowCount": 7,
"activeFlowCount": 4,
"createdAt": "2026-10-01T15:00:00.000Z",
"updatedAt": "2026-10-01T15:00:00.000Z"
}parentId es siempre null: las carpetas anidadas todavia no se exponen. activeFlowCount es la parte de flowCount con status: active.
Endpoints
| Metodo | Ruta | Descripcion |
|---|---|---|
GET | /flows/folders | Listar carpetas con sus contadores (arreglo) |
POST | /flows/folders | Crear una carpeta (201) |
PATCH | /flows/folders/:folderId | Renombrar o actualizar |
DELETE | /flows/folders/:folderId | Eliminar |
Crear / actualizar
| Campo | Tipo | Descripcion |
|---|---|---|
name | string | Requerido al crear. Maximo 120 caracteres, no vacio |
description | string | Opcional |
curl -X POST "https://api.mirlo.com/v1/flows/folders" \
-H "X-API-Key: sk_live_..." \
-H "Content-Type: application/json" \
-d '{ "name": "Ventas" }'Un nombre repetido responde 409. Una carpeta inexistente, 404.
Eliminar
Los flujos de la carpeta no se borran: quedan sin carpeta. Si la carpeta tiene subcarpetas, la respuesta es 409.