Platform

Create a runtime for a connection agent

Creates a Cloud Runtime in the end-user's org for an agent on this connection. Use instead of POST /v1/runtimes with a plt_ key (which resolves to the platform org). App must verify user intent out-of-band (e.g. wallet mandate) before calling.

post/v1/platform/connections/{connectionId}/runtimes

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/platform/connections/{connectionId}/runtimes
  • Auth: HTTP bearer

Path parameters

connectionIdstring uuid required

Request body

namestring required
agent_idstring uuid

Required when multiple agents on the connection; defaults to sole agent

templatestring
presetstring
env_publicobject
idle_timeout_secsinteger
expose_httpboolean
slugstring
inbound_authstring
startup_commandstring

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