Automations

Update automation

patch/v1/automations/{automationId}

Request

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

Path parameters

automationIdstring uuid required

Request body

namestring
cron_exprstring nullable
timezonestring
event_filterobject nullable
is_activeboolean
approval_idstring uuid

Control-plane approval authorising a widening change (adding a step that moves funds or reaches the network, raising or removing a budget cap). Required only when the org's consensus policy gates automation.widen.

version_notestring

Note recorded on the new spec version.

Response

Automation updated

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.

Changes

No recorded changes to this operation across all 1 revision of this API.