Runtimes
Create runtime
post/v1/runtimes
Request
- Base URL: https://api.1claw.co
- URL: https://api.1claw.co/v1/runtimes
- Auth: HTTP bearer
Request body
namestring required
agent_idstring uuid required
templatestring
presetstring
imagestring
environmentstring
Vault environment to resolve env vars from (e.g. production, preview, development)
env_publicobject
idle_timeout_secsinteger
expose_httpboolean
http_portinteger
slugstring
inbound_auth'api_key' | 'jwt' | 'public'
shell_access_enabledboolean
shell_auth_policystring
Step-up auth policy for shell (e.g. password, passkey, totp)
shell_max_session_minutesinteger
Response
Runtime created
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.