Automations

Create agent automation (agent-only)

Agent-scoped create for simple manual or webhook automations from chat/runtime tools. Allowed step types: log, notify, memory_get, memory_put, wait (max 10). Cron, swap, http, and transaction steps require human dashboard setup. Requires agent JWT; agent_id in path must match the caller.

post/v1/agents/{agent_id}/automations

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/automations
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required

Request body

namestring required
trigger_type'manual' | 'webhook'
auto_triggerboolean

When true (manual trigger only), start a run immediately after creation

Response

Automation created (includes one-time webhook credentials when trigger_type is webhook)

idstring uuid required
agent_idstring uuid required
namestring required
trigger_type'cron' | 'event' | 'webhook' | 'manual' required
cron_exprstring nullable
timezonestring required
event_filterobject nullable
is_activeboolean required
last_run_atstring date-time nullable
next_run_atstring date-time nullable
last_run_statusstring nullable

Status of the most recent run (enriched list field)

total_runsinteger nullable

Total runs in the last 30 days (enriched list field)

success_ratenumber nullable

Success rate percentage (enriched list field)

agent_namestring nullable

Resolved agent display name (enriched list field)

created_by_type'user' | 'agent'

Whether the automation was created by a human or agent (chat-native create)

created_atstring date-time required
updated_atstring date-time required
spec_versioninteger

Current automation_versions version.

webhook_signature_schemestring nullable

Inbound signature scheme name, never the secret.

webhook_urlstring

Full POST URL including token (one-time on create)

webhook_tokenstring

whk_ token segment (one-time on create)

Changes

No recorded changes to this operation across all 2 revisions of this API.