Runtimes

Roll back to the previous image and restart

Starts the runtime again on previous_image_digest (recorded at each start whose resolved image differed). The image must still pass the allowlist. 409 when no previous image is recorded.

post/v1/runtimes/{runtime_id}/rollback

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/runtimes/{runtime_id}/rollback
  • Auth: HTTP bearer

Path parameters

runtime_idstring uuid required

Response

Restarting on the previous image

previous_image_digeststring nullable
image_digeststring nullable

Resolved image (digest form when the provider reports one); runtime-minted agent tokens carry it as runtime_image, which access policies can require via conditions.runtime_image_in.

scheduleobject nullable
next_scheduled_start_atstring date-time nullable
scheduled_stop_atstring date-time nullable
idstring uuid required
namestring required
agent_idstring uuid required
templatestring nullable
presetstring nullable
providerstring nullable
status'creating' | 'running' | 'stopping' | 'stopped' | 'failed' | 'deleting' required
imagestring nullable
environmentstring nullable

Vault environment for env var resolution

env_publicobject nullable
idle_timeout_secsinteger nullable
expose_httpboolean nullable
slugstring nullable
public_urlstring nullable
http_portinteger nullable
inbound_auth'api_key' | 'jwt' | 'public' nullable
shell_access_enabledboolean
shell_auth_policystring
shell_max_session_minutesinteger
monthly_hours_usednumber nullable
has_paid_addonboolean

Whether this runtime has a paid Stripe add-on (unlimited hours).

billing_kind'pool' | 'included' | 'addon'

pool — counts against the plan's monthly runtime hours. included — the plan's free runtime (every plan from Pro up includes one small or medium runtime, no hour cap, no charge). addon — paid Stripe subscription item (no hour cap).

created_atstring date-time required
updated_atstring date-time required

Changes

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