Apply

Get release inventory (activation-time snapshot)

Returns the materialized state of a specific release at activation time. The response carries state_kind: "effective" for active/superseded releases (snapshot read) and state_kind: "desired_manifest" for failed/staged releases (manifest replay). Distinct from /releases/active which returns CURRENT LIVE state. Capability agent-deploy-observability.

get/apply/v1/releases/{release_id}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/apply/v1/releases/{release_id}
  • Auth: one of:
    • API key in header apikey
    • HTTP bearer

Path parameters

release_idstring required

Release ID

Query parameters

static_continuity_plan_idstring

Plan-bound continuation returned by STATIC_PATHS_REMAIN_REACHABLE.

static_continuity_cursorstring

Plan-bound continuation returned by STATIC_PATHS_REMAIN_REACHABLE.

site_limitinteger

Truncation cap for site.paths array.

Response

Release inventory

kind'release_inventory' required
schema_version'agent-deploy-observability.v1' required
release_idstring nullable required
project_idstring required
parent_idstring nullable
status'active' | 'superseded' | 'failed' | 'staged' required
manifest_digeststring required

Hex-encoded SHA-256 of the canonical manifest.

created_atstring date-time required
created_bystring nullable
activated_atstring date-time nullable
superseded_atstring date-time nullable
operation_idstring nullable
plan_idstring nullable
events_urlstring nullable

Full path to the deploy operation's event stream, if known.

effectiveboolean required

True for active/superseded releases (state was actually realized); false for failed/staged (desired-manifest only).

state_kind'current_live' | 'effective' | 'desired_manifest' required
release_generationinteger nullable required

Monotonic active-host generation used for cache keys and diagnostics.

deployment_idstring nullable

The dpl_ site deployment this release serves — what managed subdomain bindings point at and what POST /subdomains/v1 resolves a release_id to. Null for a release that never carried site files.

static_manifest_sha256string nullable required

SHA-256 of the canonical run402.static_manifest.v1 object for this materialized release.

sign_in_pathstring nullable

The app's own sign-in page for MCP authorization (site.sign_in_path), or null for the hosted page.

noindexboolean

Whether the release declared site.noindex: every response of the host carries X-Robots-Tag: noindex, nofollow, nosnippet.

Example response

{
  "routes": {
    "entries": [
      {
        "pricing": {
          "mode": "always",
          "amount_usd_micros": 250000,
          "pay_to": "org_default_payout"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.