---
title: "Render a catalog app"
method: POST
path: "/container/catalog/{source}/{id}/render"
tags: ["Container"]
---

# Render a catalog app

`POST /container/catalog/{source}/{id}/render`

## Request

- Base URL: `https://sylve.lan:8181/api`
- URL: `https://sylve.lan:8181/api/container/catalog/{source}/{id}/render`
- Auth: API key in header `Authorization`

Turn a catalog app and its settings into the containers to create: one, or a stack

## Path parameters

- `source` string, required
- `id` string, required

## Request body

- GithubComAlchemillahqSylveInternalInterfacesServicesContainerCatalogRenderRequest
  - `choices` object
  - `values` object
  - `variant` string

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalInterfacesServicesContainerCatalogPlan
  - `data` GithubComAlchemillahqSylveInternalInterfacesServicesContainerCatalogPlan
    - `containers` GithubComAlchemillahqSylveInternalInterfacesServicesContainerCreateRequest[]
      - `annotations` object
      - `catalogApp` string
      - `command` string[]
      - `cores` integer
      - `description` string
      - `entrypoint` string[]
      - `env` GithubComAlchemillahqSylveInternalDbModelsContainerEnvVar[]
        - `name` string
        - `value` string
      - `extraHosts` string[]
      - `hostname` string
      - `image` string
      - `ip` string
      - `memory` integer
      - `mounts` GithubComAlchemillahqSylveInternalDbModelsContainerMount[]
        - `guid` string
        - `mode` string
        - `owner` string
        - `readOnly` boolean
        - `source` string
        - `target` string
        - `type` 'volume' | 'dataset' | 'path'
      - `name` string, required
      - `network` string
      - `ocId` integer, required
      - `os` string
      - `pool` string, required
      - `ports` GithubComAlchemillahqSylveInternalDbModelsContainerPort[]
        - `containerPort` integer
        - `hostIp` string
        - `hostPort` integer
        - `protocol` string
      - `pullImage` boolean
      - `restart` string
      - `restartRetries` integer
      - `shmSize` string
      - `stack` string
      - `startAfterCreate` boolean
      - `startAtBoot` boolean
      - `startOrder` integer
      - `stopTimeout` integer
      - `user` string
      - `webHttps` boolean
      - `webPort` integer
      - `workDir` string
    - `stack` string
  - `error` string
  - `message` string
  - `status` string

## Changes

- **2026-11-03** `9565cdd0abf5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/container/catalog/:source/:id/render/post.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) - [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/9565cdd0abf5?raw)