Apply

Get deploy operation snapshot

Snapshot the deploy operation: status, progress, structured error, payment requirement. Read-only. Polled by the SDK during long-running commits.

get/apply/v1/operations/{operation_id}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/apply/v1/operations/{operation_id}
  • Auth: API key in header apikey

Path parameters

operation_idstring required

Operation ID

Response

Operation snapshot

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

plan_idstring required
base_release_idstring nullable
target_release_idstring nullable
status'planning' | 'uploading' | 'committing' | 'staging' | 'gating' | 'migrating' | 'schema_settling' | 'activating' | 'activation_pending' | 'needs_repair' | 'ready' | 'failed' | 'rolled_back' required
activate_attemptsinteger required
created_atstring date-time required
updated_atstring date-time required
operation_idstring required
release_idstring nullable
urlsobject nullable

site is the project's public URL, present when the project owns at least one subdomain. console is the project's page in the console (https://console.run402.com/orgs/{org_id}/projects/{project_id}), present exactly when site is present; a function-only project with no site carries no console key either.

Example response

{
  "project_id": "prj_1741340000_0042",
  "payment_required": {
    "asset": "USDC",
    "reason": "lease_renewal"
  },
  "rehearsal_report": {
    "source_project_id": "prj_1741340000_0042",
    "next_actions": [
      {
        "method": "POST",
        "path": "/tiers/v1/hobby",
        "auth": "x402"
      }
    ]
  },
  "next_actions": [
    {
      "method": "POST",
      "path": "/tiers/v1/hobby",
      "auth": "x402"
    }
  ]
}

Changes

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