List automations
List saved Assistant automations for the authenticated merchant.
Related endpoints
POST /automations— Create an automationGET /automations/{id}— Retrieve an automationGET /automations/{id}/runs— List runs for an automationPOST /automations/{id}/runs— Run an automationGET /automations/{id}/runs/{runId}— Retrieve a runGET /automations/approvals— List approvalsPOST /automations/approvals/{approvalId}/approve— Approve an automation approvalPOST /automations/approvals/{approvalId}/reject— Reject an automation approval
Common errors
400 invalid_request— malformed payload or failed validation.401 unauthenticated— missing, malformed, or revoked API key.
Pagination
Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.
x-api-key<token>
Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.
In: header
Query Parameters
status?string
Filter automations by status (e.g. active, paused, archived).
trigger_type?string
Filter automations by trigger type (e.g. schedule, manual, event).
limit?number
Maximum number of automations to return (1-100, default 25).
Default
25Range
1 <= value <= 100Response Body
application/json
curl "https://api.revkeen.com/v2/automations" \ -H "x-api-key: $REVKEEN_API_KEY"{
"object": "list",
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"object": "automation",
"name": "string",
"description": "string",
"status": "string",
"trigger_type": "string",
"timezone": "string",
"cron_expression": "string",
"risk_profile": "string",
"current_version": 0,
"objective": "string",
"created_at": "string",
"updated_at": "string"
}
]
}Empty
Empty