Skip to main content
Restart the agent process without redeploying the binary, for example after a config change or when the process is stuck. The agent re-registers with the control plane on start.

Endpoint

Authentication

Authorization: Bearer <api_key or JWT> with fleet management rights on the target agent.

Path parameters

string
required
Agent identifier.

Response

integer
0 when the restart request is accepted.
object
Command envelope, usually { "ok": true, "command_id": "..." } for the queued restart command.

Example

The restart runs asynchronously. Poll the agent status endpoint to confirm the agent is back online.