Apply

Get the active release's CURRENT LIVE state

Returns the materialized state of the active release as it stands RIGHT NOW (live tables read). A setSecret() call between activation and now WILL appear in this response — distinct from /releases/{release_id} which returns the activation-time snapshot. The response's state_kind field is "current_live". Returns 404 NO_ACTIVE_RELEASE if the project has no active release.

get/apply/v1/releases/active

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/apply/v1/releases/active
  • Auth: API key in header apikey

Query parameters

site_limitinteger

Response

Current-live 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.