Create an automation
Create a saved Assistant automation definition and immutable first version.
Related endpoints
GET /automations— List automationsGET /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.409 conflict— Idempotency-Key collision with a different body, or a concurrent state-transition conflict.
Idempotency
Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
Stuck on an error response? Ask the RevKeen assistant to explain it.
curl -X POST "https://api.revkeen.com/v2/automations" \
-H "x-api-key: $REVKEEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"objective": "string"
}'{
"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",
"system_prompt": "string",
"trigger_config": null,
"plan": null,
"tool_allowlist": null,
"approval_policy": null,
"memory_policy": null,
"notification_policy": null,
"source_thread_id": "b736ec5d-eb67-4368-a52e-4c5c02196509",
"source_message_id": "422efc8e-5e68-4d36-8b87-fc5bb43ded95"
}
}{
"error": "Bad request"
}{
"error": "Unauthorized"
}{
"error": "conflict",
"code": "assistant_agent_template_conflict",
"message": "string",
"template_id": "payment_recovery",
"existing_automation_id": "1ce65de8-d83e-465c-8e9a-bfa057a5aaf8"
}