Activities

Activities let you execute runtime actions on your deployment nodes — start, stop, restart, and reconfigure — and track their progress. Every action is recorded per-node with status updates, so you always know what happened, when, and who triggered it.

Runtime Actions

You can execute these actions on deployment runtimes:

Supported Runtimes

Activity Status

How It Works

1. You trigger a runtime action from the Console or API
2. The Supervisor dispatches the action as a task to each targeted node
3. The Warden agent on each node executes the action
4. Activity status updates to completed or rejected once the node reports back

You can target specific nodes or all nodes in the deployment. Each node gets its own activity entry with independent status tracking.

API Reference

Execute a Runtime Action

curl -X POST {supervisor_url}/deployments/{deployment_id}/activities/{runtime}/{action} \
  -H "ld-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

To target specific nodes:

curl -X POST {supervisor_url}/deployments/{deployment_id}/activities/iggy/restart \
  -H "ld-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nodes": [610809900976570889]
  }'

Path parameters:

• runtime — one of: iggy, connectors
• action — one of: start, stop, restart, reconfigure:{config_id}

Request body (optional):

• nodes — array of node IDs to target. Omit or pass {} to target all nodes.

Returns 202 Accepted.

Required permission: deployment:manage

List Activities

curl "{supervisor_url}/deployments/{deployment_id}/activities?page=1&results=10" \
  -H "ld-api-key: YOUR_API_KEY"

{
  "items": [
    {
      "id": 1,
      "tenant_id": 1,
      "division_id": 1,
      "environment_id": 1,
      "deployment_id": 1,
      "author_id": 42,
      "runtime": "iggy",
      "action": "restart",
      "node_id": 610809900976570889,
      "status": "completed",
      "created_at": "2026-03-16T12:00:00Z",
      "finished_at": "2026-03-16T12:00:05Z"
    }
  ],
  "page": 1,
  "total_results": 1,
  "total_pages": 1
}

Required permission: deployment:read