---
title: "Get a space's runtime status"
method: GET
path: "/v1/spaces/{spaceId}/runtime"
tags: ["Runtime"]
---

# Get a space's runtime status

`GET /v1/spaces/{spaceId}/runtime`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/runtime`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the serving runtime's health and placement for this space: instance, region, and serving state.

## Path parameters

- `spaceId` string, required

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `liveVersionId` string, nullable, required: Version that the live space URL now points to, if any.
    - `pendingVersionId` string, nullable, required: Version that live traffic is trying to publish now, if any.
    - `liveUrl` string, nullable, required: Live space URL. It moves to the latest version after a successful publish to `live`.
    - `runtimeState` 'provisioning' | 'active' | 'updating' | 'deleting' | 'failed', required: Space operation-lifecycle status.
    - `liveVersionStatus` 'building' | 'prepared' | 'created' | 'uploading' | 'uploaded' | 'finalizing' | 'ready' | 'failed' | 'expired' | 'canceled', nullable, required
    - `pendingVersionStatus` 'building' | 'prepared' | 'created' | 'uploading' | 'uploaded' | 'finalizing' | 'ready' | 'failed' | 'expired' | 'canceled', nullable, required
    - `operation` object, nullable, required
      - `id` string, required
      - `kind` string, required
      - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
      - `resources` object[], required
        - `type` string, required
        - `id` string, required
      - `progress` object
        - `total` integer, required
        - `completed` integer, required
        - `failed` integer, required
      - `diagnostics` object[]
        - `code` string, required: Stable snake_case diagnostic code naming the public contract that produced it.
        - `severity` 'info' | 'warning' | 'error', required: How actionable the diagnostic is.
        - `message` string, required: Human-readable explanation with enough detail to act on.
        - `path` string, nullable: Artifact path the diagnostic points at, for example "_headers:12", when one exists.
        - `provider` 'infra' | 'dns' | 'registrar' | 'runtime', nullable: Upstream system the diagnostic originated from, when not Spacefast itself.
        - `details` object, nullable: Machine-readable context for the diagnostic code.
        - `fix` string, nullable: Concrete, agent-actionable remediation hint, when one can be derived.
        - `retryable` boolean, nullable: Whether retrying the same operation can resolve this diagnostic without the caller changing anything.
      - `createdAt` string, date-time, required
      - `finishedAt` string, date-time
    - `app` object, nullable, required: What the live version runs: its Zero capsule and its Functions worker, each null when the published tree carries none of that product (both null for a space without a runtime). The whole object is null for callers whose credential does not carry `versions:read`, because app details read version contents, not serving state.
      - `capsule` object, nullable, required: The live version's Zero capsule, if it carries one.
        - `artifactId` string, required
        - `appName` string, required
        - `serverRuntime` 'quickjs-rust', required
        - `inspect` object, required
          - `policy` 'private' | 'public', required
        - `install` object, required
          - `runtimeKind` 'zero', required
          - `engine` 'quickjs-rust', required
          - `storageRoot` '__spacefast/zero', required
          - `artifactPath` '__spacefast/zero/artifact.json', required
          - `configPath` '__spacefast/zero/config.json', required
          - `binary` object, required
            - `path` '__spacefast/zero/bin/stattic-runtime', required
            - `compatibilityTarget` object, required
              - …
            - `sha256` string, nullable, required
            - `required` true, required
          - `mysql` object, required
            - `migrateAtFinalize` true, required
            - `blockIncompatibleRollback` true, required
          - `realtime` object, required
            - `production` 'central', required
            - `local` 'foreground-cli-ws', required
        - `tables` string[], required
        - `queries` string[], required
        - `mutations` string[], required
        - `actions` string[]: Action names. Included when Accept requests application/json; spacefast-capsule-actions=1.
        - `endpoints` object[], required
          - `mode` 'read' | 'write', required
          - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS', required
          - `path` string, required
        - `sockets` string[], required
        - `serverBundleSize` integer, nullable, required: Compiled server bundle size in bytes, or null when this version's metadata does not record it.
        - `clientBundleSize` integer, nullable, required: Compiled client bundle size in bytes, or null when this version's metadata does not record it.
        - `migrationCount` integer, required
        - `schemaHash` string, nullable, required
        - `variables` object, required
          - `source` 'stattic-variables', required
          - `names` string[], required
        - `realtime` object, required
          - `mode` 'central' | 'cast' | 'local', required
          - `centralUrl` string, uri, nullable, required
          - `path` string
          - `replayPath` string, nullable
          - `replayUrl` string, uri, nullable
          - `runPath` string, nullable
          - `runUrl` string, uri, nullable
          - `resourceKey` string, nullable
          - `ticketPath` string, nullable
          - `socketPath` string, nullable
          - `spaceId` string, nullable
          - `versionId` string, nullable
      - `worker` object, nullable, required: The live version's Functions worker, if it carries one.
        - `artifactId` string, required
        - `appName` string, required
        - `entry` string, required
        - `compatibilityDate` string, required
        - `compatibilityFlags` string[], required
        - `routes` object[], required
          - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS', nullable, required
          - `path` string, required
          - `subtree` boolean, required
        - `capabilities` object, required
          - `db` boolean
          - `fetch` boolean
          - `auth` boolean
          - `env` boolean
          - `realtime` boolean
          - `logging` boolean
          - `gravatar` boolean
          - `spam` boolean
          - `email` boolean
          - `content` boolean
          - `storage` boolean
          - `connectors` boolean
          - `crypto` boolean
        - `executionState` 'absent' | 'ready' | 'serving', required
        - `bundleSize` integer, required
        - `bundleSha256` string, required
        - `variables` object, required
          - `source` 'spacefast-variables', required
          - `names` string[], required
    - `pendingApp` object, nullable, required: What the pending version would run — the same projection as `app`, read from `pendingVersionId`'s version so a dashboard can show what an in-flight publish is about to serve. Null when no publish is in flight, and null for callers without `versions:read`, exactly like `app`.
      - `capsule` object, nullable, required: The live version's Zero capsule, if it carries one.
        - `artifactId` string, required
        - `appName` string, required
        - `serverRuntime` 'quickjs-rust', required
        - `inspect` object, required
          - `policy` 'private' | 'public', required
        - `install` object, required
          - `runtimeKind` 'zero', required
          - `engine` 'quickjs-rust', required
          - `storageRoot` '__spacefast/zero', required
          - `artifactPath` '__spacefast/zero/artifact.json', required
          - `configPath` '__spacefast/zero/config.json', required
          - `binary` object, required
            - `path` '__spacefast/zero/bin/stattic-runtime', required
            - `compatibilityTarget` object, required
              - …
            - `sha256` string, nullable, required
            - `required` true, required
          - `mysql` object, required
            - `migrateAtFinalize` true, required
            - `blockIncompatibleRollback` true, required
          - `realtime` object, required
            - `production` 'central', required
            - `local` 'foreground-cli-ws', required
        - `tables` string[], required
        - `queries` string[], required
        - `mutations` string[], required
        - `actions` string[]: Action names. Included when Accept requests application/json; spacefast-capsule-actions=1.
        - `endpoints` object[], required
          - `mode` 'read' | 'write', required
          - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS', required
          - `path` string, required
        - `sockets` string[], required
        - `serverBundleSize` integer, nullable, required: Compiled server bundle size in bytes, or null when this version's metadata does not record it.
        - `clientBundleSize` integer, nullable, required: Compiled client bundle size in bytes, or null when this version's metadata does not record it.
        - `migrationCount` integer, required
        - `schemaHash` string, nullable, required
        - `variables` object, required
          - `source` 'stattic-variables', required
          - `names` string[], required
        - `realtime` object, required
          - `mode` 'central' | 'cast' | 'local', required
          - `centralUrl` string, uri, nullable, required
          - `path` string
          - `replayPath` string, nullable
          - `replayUrl` string, uri, nullable
          - `runPath` string, nullable
          - `runUrl` string, uri, nullable
          - `resourceKey` string, nullable
          - `ticketPath` string, nullable
          - `socketPath` string, nullable
          - `spaceId` string, nullable
          - `versionId` string, nullable
      - `worker` object, nullable, required: The live version's Functions worker, if it carries one.
        - `artifactId` string, required
        - `appName` string, required
        - `entry` string, required
        - `compatibilityDate` string, required
        - `compatibilityFlags` string[], required
        - `routes` object[], required
          - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS', nullable, required
          - `path` string, required
          - `subtree` boolean, required
        - `capabilities` object, required
          - `db` boolean
          - `fetch` boolean
          - `auth` boolean
          - `env` boolean
          - `realtime` boolean
          - `logging` boolean
          - `gravatar` boolean
          - `spam` boolean
          - `email` boolean
          - `content` boolean
          - `storage` boolean
          - `connectors` boolean
          - `crypto` boolean
        - `executionState` 'absent' | 'ready' | 'serving', required
        - `bundleSize` integer, required
        - `bundleSha256` string, required
        - `variables` object, required
          - `source` 'spacefast-variables', required
          - `names` string[], required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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