Automations

Cancel a running automation run

Cancel a run that is currently in running or awaiting_approval status. Returns the updated run with status cancelled.

post/v1/automations/{automationId}/runs/{runId}/cancel

Request

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

Path parameters

automationIdstring uuid required
runIdstring uuid required

Response

Run cancelled

idstring uuid required
automation_idstring uuid required
agent_idstring uuid required
status'running' | 'success' | 'completed_with_skips' | 'failed' | 'timed_out' | 'cancelled' | 'awaiting_approval' | 'waiting' | 'awaiting_callback' required

awaiting_approval, waiting (a wait_until park) and awaiting_callback are parked states: the run's clock is stopped and it continues when the approval is decided, the wake time passes, or the callback URL is posted to.

paused_reason'approval' | 'wait_until' | 'callback' nullable
paused_at_stepinteger nullable
paused_approval_idstring uuid nullable
paused_untilstring date-time nullable
paused_expires_atstring date-time nullable
spec_versioninteger nullable
idempotency_keystring nullable
parent_run_idstring uuid nullable

Set when a call_automation step started this run.

step_resultsunknown
errorstring nullable
trigger_sourcestring nullable
contextobject nullable

JSONB context passed between workflow steps

started_atstring date-time required
finished_atstring date-time nullable
tokens_usedinteger required
cost_centsinteger required

Changes

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