Skip to main content
Restart the agent process without redeploying the binary. Useful after configuration changes 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 on accepted restart request.
object
Command envelope; typically { "ok": true, "command_id": "..." } for the queued restart command.

Example

The restart is asynchronous. Poll the agent status endpoint to confirm it has come back online.