Worker Disconnect

Mark a worker as disconnected/offline.

This endpoint is called by workers when they:

• Shut down gracefully (Ctrl+C)
• Exit due to an error
• Crash unexpectedly (via atexit handler)

Args: worker_id: Worker ID (UUID) disconnect: Disconnect details (reason, exit code, error)

POST /api/v1/workers/{worker_id}/disconnect

Worker Disconnect

cURL

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/workers/{worker_id}/disconnect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "shutdown",
  "exit_code": 123,
  "error_message": "<string>"
}
'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Path Parameters

worker_id · string · required

Body

application/json

Worker disconnect request

reason · string · default: shutdown

exit_code · integer | null

error_message · string | null

Response

204

Successful Response