v34

latestOpenAPI 3.1.0AGPL-3.0-onlyraw.githubusercontent.com2026-08-018932140.9 KB
Stacks

Update or rebuild one Compose service

Manually pulls or builds one declared service, then recreates only that service with --no-deps --force-recreate. Multi-service stacks only. Requires stack:deploy. Automation paths continue to update the full stack.

post/api/stacks/{stackName}/services/{serviceName}/update

Path parameters

stackNamestring required
Example:my-stack

Stack directory name. Must match ^[a-zA-Z0-9_-]+$ (alphanumeric characters, hyphens, and underscores only). Returns 400 Invalid stack name if the name contains path separators, dots, spaces, or other special characters.

serviceNamestring required

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.

Response

Service update completed.

serviceNamestring required
healthGateIdstring nullable required
observingboolean required
recoveryIdstring nullable
recoveryAvailableboolean required
recheckWarningstring