---
title: "Get runtime"
method: GET
path: "/v1/runtimes/{runtimeId}"
tags: ["Runtimes"]
---

# Get runtime

`GET /v1/runtimes/{runtimeId}`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/runtimes/{runtimeId}`
- Auth: HTTP bearer

## Path parameters

- `runtimeId` string, uuid, required

## Response `200`

Runtime details

- RuntimeResponse
  - `previous_image_digest` string, nullable
  - `image_digest` string, 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`.
  - `schedule` object, nullable
  - `next_scheduled_start_at` string, date-time, nullable
  - `scheduled_stop_at` string, date-time, nullable
  - `id` string, uuid, required
  - `name` string, required
  - `agent_id` string, uuid, required
  - `template` string, nullable
  - `preset` string, nullable
  - `provider` string, nullable
  - `status` 'creating' | 'running' | 'stopping' | 'stopped' | 'failed' | 'deleting', required
  - `image` string, nullable
  - `environment` string, nullable: Vault environment for env var resolution
  - `env_public` object, nullable
  - `idle_timeout_secs` integer, nullable
  - `expose_http` boolean, nullable
  - `slug` string, nullable
  - `public_url` string, nullable
  - `http_port` integer, nullable
  - `inbound_auth` 'api_key' | 'jwt' | 'public', nullable
  - `shell_access_enabled` boolean
  - `shell_auth_policy` string
  - `shell_max_session_minutes` integer
  - `monthly_hours_used` number, nullable
  - `has_paid_addon` boolean: 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_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Authentication required or invalid
- `404`: Resource not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)