---
title: "Preview compose services"
method: POST
path: "/api/v1/deploy/application/preview-compose"
tags: ["preview-compose", "api/v1/deploy", "application"]
---

# Preview compose services

`POST /api/v1/deploy/application/preview-compose`

Preview compose services.

Auth: Required (bearer token).
Scope: Organization-scoped in authenticated context.
Side effects: May mutate server state.

## Headers

- `Accept` string

## Response `200`

OK

- PreviewComposeResponse — PreviewComposeResponse schema
  - `services` object[]
    - `port` integer
    - `service_name` string

## Other responses

- `400` — Bad Request _(validation or deserialization error)_
- `500` — Internal Server Error _(panics)_
- `default`

## Changes

- **2026-03-09** `344ac18cbced` — 24 warning, 14 info
  - removed the optional property `detail` from the response with the `400` status (media type: application/json)
  - removed the optional property `detail` from the response with the `400` status (media type: application/xml)
  - removed the optional property `detail` from the response with the `500` status (media type: application/json)
  - removed the optional property `detail` from the response with the `500` status (media type: application/xml)
  - …34 more
- **2026-02-28** `23c057049fa7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nixopus/apis/openapi/changes/api/v1/deploy/application/preview-compose/post.md)

---

[API](https://skmtc.dev/nixopus/apis/openapi.md) · [All operations](https://skmtc.dev/nixopus/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nixopus/openapi/revisions/344ac18cbced/schema)