API ReferenceAutomations
List automations
Most recently changed first (up to 100). managedBy marks automations that belong to an agent or a Nimply feature: those are read-only here.
Authorization
api-key AuthorizationBearer <token>
Workspace API key (nim_live_...)
In: header
Query Parameters
status?string
Value in
- "DRAFT"
- "ACTIVE"
- "PAUSED"
Response Body
application/json
curl -X GET "https://example.com/v1/automations"{ "data": [ { "id": "9d2f4b1a-6c3e-4f8a-b5d7-1e0a2c4b6d8f", "name": "Monday planning reminder", "description": "string", "status": "DRAFT", "pausedReason": "CHANNEL_REMOVED", "managedBy": null, "trigger": { "type": "trigger.schedule", "summary": "On a schedule (0 9 * * 1 UTC)" }, "steps": [ { "id": "notify", "type": "action.notify", "name": "Send notification", "summary": "message: Time to plan the week" } ], "graph": { "nodes": [ { "id": "notify", "type": "action.notify", "name": "Remind the team", "position": { "x": 420, "y": 200 }, "params": {} } ], "edges": [ { "id": "e1", "source": "trigger", "target": "notify", "sourceHandle": "main" } ] }, "tags": [ "planning" ], "version": 1, "activateInApp": false, "lastRunAt": "string", "nextRunAt": "string", "createdAt": "2026-10-29T09:00:00.000Z", "updatedAt": "2026-10-29T09:00:00.000Z", "appUrl": "https://app.nimply.io/workspace/8b2e5821-…/automations/9d2f4b1a-…" } ]}