Skip to main content

Container Deployment & Execution Management

Overview

The container workflow has been divided into three dedicated articles.

This article specifically covers Container Deployment & Execution Management, which focuses on deploying, and execution command on edge devices.

Basic Operations

Basic API URL: https://{domain}/{tenantPath}/{srp}

OperationAPIDescription
Deploy Container Stack to DevicesPOST {Basic API URL}/api/v1/orgs/{orgId}/stack-configs/{stackConfigId}/revisions/{stackRevisionId}:deployDeploy a specific revision of a container stack configuration to WEDA Nodes
List Docker Stacks on DeviceGET {Basic API URL}/api/v1/devices/{deviceId}/docker/stacksGet a list of Docker stacks currently deployed on a specific device
Execute Docker Stack CommandPOST {Basic API URL}/api/v1/devices/{deviceId}/docker/stacks/commands:{action}Execute a Docker stack command on a specific device
Get Docker Stack Command ResultsGET {Basic API URL}/api/v1/devices/{deviceId}/docker/stacks/commands/resultsGet results of previously executed Docker stack commands on a specific device
Delete Stacks from DeviceDELETE {Basic API URL}/api/v1/devices/{deviceId}/docker/stacksUndeploy Docker stacks from a specific device

Constraints & Limitations

General

  • API access requires authentication with a valid token
  • Organization must exist
  • Device must be online for deployment and command execution
  • Container stack and revision must exist for deployment

Deploy Container

  • deviceIds, max 128 devices per batch deployment.

Execute Command

  • action can be start, stop, pause, resume, restart

Advanced Features

Other Container Deployment APIs

OperationAPIDescription
List Stack DeploymentsGET {Basic API URL}/api/v1/orgs/{orgId}/stack-configs/deploymentsGet a list of all stack deployments across devices in an organization
Delete Stack Deployments from DeviceDELETE {Basic API URL}/api/v1/devices/{deviceId}/stacks/deploymentsRemove all currently deployed container stacks from a specific device

Last updated on Apr-8, 2026 | Version 1.0.0