Automations

Resume a run parked on an approval

An approval_request step parks the run in awaiting_approval and stops the clock. Deciding that approval — via the API, the one-tap email link or the phone — resumes the run automatically: approved continues from the next step, rejected fails the run with the reason. This route is the hand-off for a decision made elsewhere: it marks the approval approved on the caller's behalf and continues the run. Human-only. Idempotent — a run that is not parked is returned unchanged. Later steps see the approval step's output as {status, approval_id} and the optional payload as {{resume.*}}. A parked run that nobody decides within 72 hours becomes timed_out. Emits automation.run.resumed.

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

Request

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

Path parameters

automationIdstring uuid required
runIdstring uuid required

Request body

payloadobject

Exposed to later steps as {{resume.*}}.

Response

The run, now running (or unchanged if it was not parked)

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.