Platform

List your custom deployments

last_operation.progress reports supported, step, label, reported_at, age_seconds, recovery and reason. Agent 0.6.6+ reports the last step, not a live percentage. Saved final results are resent after restart without re-execution. Agent 0.6.7+ may reconcile a completed preparation checkpoint (recovery=reconciling), restore previous configuration and close the attempt without replay. Unconfirmed work, missing proof or replacement uncertainty remains recovery=required and needs support. Wait for a terminal result before retrying. Agent 0.6.8+ can wait for supervised pull/build completion (recovery=reconciling). Only a verified successful receipt permits preparation reconciliation; missing/invalid receipts, worker failure or timeout require review. Agent 0.6.9+ also waits for the original supervised replacement (step=reconciling_replacement), including startup checks, hooks, routes and normal recovery. Its verified final outcome is delivered without repeating deployment. Missing proof still blocks the queue. See the development status in the deployment progress guide before assuming availability. See https://docs.imprezahost.com/deployment-progress.html. Includes runtime (recent container observation) and last_operation (latest deployment/update/rollback/restart/uninstall job). Agent 0.6.4+ observations expire after 120 seconds; agent silence over 90 seconds yields unknown. Inspect runtime.reason and observed_at. Legacy status and last_health_at are historical, not current availability. See https://docs.imprezahost.com/runtime-health.html for states and scope. Returns custom (non-catalog) deployments — apps the customer shipped themselves as a public image, Dockerfile, git URL, or full manifest. Per-account isolated by design: one customer's custom apps never surface in another's listing.

get/platform/deployments/custom

Request

  • Base URL: https://api.imprezahost.com/v1
  • URL: https://api.imprezahost.com/v1/platform/deployments/custom
  • Auth: API key in header X-API-Key and API key in header X-API-Secret

Query parameters

agent_idstring

Only return custom deployments running on this agent.

Response

Custom deployment list

Changes

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