Automations

Roll back to an earlier spec version

Publishes the chosen version's spec as a new version and makes it current. Human-only. A rollback that widens what the automation can do relative to the live spec goes through the automation.widen control-plane consensus gate, like an edit would.

post/v1/automations/{automationId}/versions/{version}/rollback

Request

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

Path parameters

automationIdstring uuid required
versioninteger required

Request body

notestring
approval_idstring uuid

Control-plane approval when rolling back to a wider spec.

Response

The automation with the rolled-back spec current

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 2 revisions of this API.