---
title: "List your custom deployments"
method: GET
path: "/platform/deployments/custom"
tags: ["Platform"]
---

# List your custom deployments

`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`

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.

## Query parameters

- `agent_id` string

## Response `200`

Custom deployment list

## Other responses

- `401`: Invalid or missing API credentials

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)