Organization

Create a card-gated trial runtime

Verifies the given SetupIntent succeeded, then delegates to the same runtime-creation logic POST /v1/runtimes uses. Only reachable once the guided onboarding wizard has a confirmed SetupIntent for the org.

post/v1/onboarding/guided/trial/runtime

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/onboarding/guided/trial/runtime
  • Auth: HTTP bearer

Request body

setup_intent_idstring required
agent_idstring uuid required
templatestring required
presetstring

Defaults to CreateRuntimeRequest's own default ("small") when omitted.

namestring required
always_onboolean

Keeps the runtime running indefinitely instead of auto-stopping after the default idle window (maps to idle_timeout_secs: 0).

env_publicobject

Non-secret runtime config — in practice just LLM_PROVIDER/LLM_MODEL from the guided flow's model-choice step. Rejected if any key looks secret-shaped (same validate_env_public the canonical runtime API uses).

Response

Created runtime

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.