Stacks

Create a new stack

Creates a new stack directory with a default compose.yaml file.

post/api/stacks

Headers

x-node-idinteger

Example:1

Target a specific node by ID. If omitted, the default node is used. Can also be passed as ?nodeId= query parameter.

Request body

stackNamestring required

Stack name. Alphanumeric characters, hyphens, and underscores only.

Example request

{
  "stackName": "my-new-stack"
}

Response

Stack created.

messagestring required

namestring required

Example response

{
  "message": "Stack created successfully",
  "name": "my-new-stack"
}

Changes

Changed in 2 of the 36 revisions of this API.36

Jun 4, 2026d58cf9d6195b3See the full diff
- ○
  removed the ADMIRAL_REQUIRED enum value from the code response property for the response status 400
  response-property-enum-value-removed
- ○
  removed the ADMIRAL_REQUIRED enum value from the code response property for the response status 409
  response-property-enum-value-removed
- ○
  removed the ADMIRAL_REQUIRED enum value from the code response property for the response status 500
  response-property-enum-value-removed
Apr 5, 20267464894ea58233See the full diff
- ●
  added the new PAID_REQUIRED enum value to the code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new PAID_REQUIRED enum value to the code response property for the response status 409
  response-property-enum-value-added
- ●
  added the new PAID_REQUIRED enum value to the code response property for the response status 500
  response-property-enum-value-added
- ○
  removed the PRO_REQUIRED enum value from the code response property for the response status 400
  response-property-enum-value-removed
- ○
  removed the PRO_REQUIRED enum value from the code response property for the response status 409
  response-property-enum-value-removed
- ○
  removed the PRO_REQUIRED enum value from the code response property for the response status 500
  response-property-enum-value-removed