Cómo llamar a la API de Worknano
Vive en la documentación, no como pestaña de Config ni como ítem de menú aparte. Cada módulo, la misma forma HTTP: task, deal, contact o un modelo que añadas después.
El trabajo diario del producto sigue en la app. Usa esto cuando otro sistema deba leer o escribir un registro. Dentro del workspace, un paso de flujo llama a un endpoint. Claves en Secrets.
Leer y listar
- Leer un registro:
GET /api/v1/object/task/123. Cambiataskpor el modelo y123por el id. - Listar:
GET /api/v1/objects/task?status=ACTIVE&_limit=50. Filtra con campos de query que el modelo ya tiene. - Igual para
deal,contacto cualquier otro modelo. No aprendes un path nuevo por módulo.
Crear, actualizar, borrar
- Crear:
POST /api/v1/object/taskcon un cuerpo JSON de los campos que quieres poner. - Actualizar:
PATCH /api/v1/object/taskcon el id y los campos que cambiaron. - Borrar:
DELETE /api/v1/object/task/123.
No inventes un verbo ni un path nuevo para tickets, ideas o un modelo que añadiste en Config. Cambia el nombre del modelo. Usa campos que ya existen. Ver Modelos.
Cómo se ata a la app
- Abre Config → Integrations. Pon URL, método y auth. El mapping del cuerpo y la respuesta va en el paso del flujo.
- En el registro, pulsa la acción ⋮ que corre ese flujo. No escribas un handler suelto en una página.
- Si el paso falla, abre el log de API en esa misma pantalla de Integrations. Ves request, response, estado y duración.
- Las claves API se quedan en Secrets, no en la página.
Para que apps de IA como Claude, Cursor o Codex trabajen en el workspace, consulta MCP.