---
title: "Create a catalog app's stack"
method: POST
path: "/container/stack"
tags: ["Container"]
---

# Create a catalog app's stack

`POST /container/stack`

## Request

- Base URL: `https://sylve.lan:8181/api`
- URL: `https://sylve.lan:8181/api/container/stack`
- Auth: API key in header `Authorization`

Queue the creation of the containers of a catalog app that runs as several, on a network of their own, with the free container IDs from ocId on. The task belongs to the first container; when a container cannot be created or started, none are kept.

## Request body

- GithubComAlchemillahqSylveInternalInterfacesServicesContainerStackRequest
  - `containers` GithubComAlchemillahqSylveInternalInterfacesServicesContainerCreateRequest[], required
    - `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
  - `ocId` integer, required
  - `pool` string, required
  - `stack` string, required
  - `startAtBoot` boolean

## Response `202`

Accepted

- GithubComAlchemillahqSylveInternalAPIResponseInternalHandlersContainerStackResponse
  - `data` InternalHandlersContainerStackResponse
    - `action` string
    - `containers` InternalHandlersContainerStackMember[]
      - `name` string
      - `ocId` integer
    - `ocId` integer
    - `outcome` string
    - `taskId` integer
  - `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/stack/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)