Hoe je de Worknano API aanroept

Updated 2026-10-26

Dit staat in de hub docs, niet als een Config-tabblad en niet als een apart menu-item. Elke module gebruikt dezelfde HTTP-vorm: task, deal, contact, of een model dat je later toevoegt.

Dagelijks productwerk gebeurt nog steeds in de app. Gebruik dit als een ander systeem een record moet lezen of schrijven. In de werkruimte roept een stap van een workflow een endpoint aan. Bewaar sleutels in Secrets.

Hoe je leest en lijst

1. Lees één record: GET /api/v1/object/task/123. Wissel task voor de modelnaam en 123 voor het id.
2. Lijst records: GET /api/v1/objects/task?status=ACTIVE&_limit=50. Filter met queryvelden die het model al heeft.
3. Doe hetzelfde voor deal, contact of elk ander model. Je leert geen nieuw pad per module.

Hoe je maakt, bijwerkt en verwijdert

1. Maken: POST /api/v1/object/task met een JSON-body van de velden die je wilt zetten.
2. Bijwerken: PATCH /api/v1/object/task met het id en de velden die zijn gewijzigd.
3. Verwijderen: DELETE /api/v1/object/task/123.

Je verzint geen nieuw werkwoord of een nieuw pad voor tickets, ideeën of een model dat je in Config hebt toegevoegd. Wissel de modelnaam. Geef de voorkeur aan bestaande velden. Zie Models.

Hoe dit aan de app vastzit

1. Open Config → Integrations. Voeg de URL, methode en auth toe. De mapping van de body en het antwoord zit op de workflowstap.
2. Klik op een record de actie ⋮ die die workflow draait. Je schrijft geen eenmalige page handler.
3. Faalt de stap, open dan de API log op hetzelfde Integrations-scherm. Je ziet request, response, status en duur.
4. Houd API-sleutels in Secrets, niet op de pagina.

Terug naar Config of de docskaart.

Wil je AI-apps zoals Claude, Cursor of Codex in de werkruimte laten werken, zie MCP.