RevKeen Docs
Api reference

Create an automation

Create a saved Assistant automation definition and immutable first version.

Related endpoints

  • GET /automations — List automations
  • GET /automations/{id} — Retrieve an automation
  • GET /automations/{id}/runs — List runs for an automation
  • POST /automations/{id}/runs — Run an automation
  • GET /automations/{id}/runs/{runId} — Retrieve a run
  • GET /automations/approvals — List approvals
  • POST /automations/approvals/{approvalId}/approve — Approve an automation approval
  • POST /automations/approvals/{approvalId}/reject — Reject an automation approval

Idempotency

Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.

POST
/automations

Authorization

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

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"
  }
}
Edit on GitHub