---
title: "Create a container"
method: POST
path: "/container"
tags: ["Container"]
---

# Create a container

`POST /container`

## Request

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

Queue the creation of a container; the image is pulled if missing

## Request body

- 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

## Response `202`

Accepted

- GithubComAlchemillahqSylveInternalAPIResponseInternalHandlersContainerTaskResponse
  - `data` InternalHandlersContainerTaskResponse
    - `action` string
    - `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/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)