Delete an agent - Qoder CN

Permanently delete an agent. This operation is irreversible.

Request headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT>`

Parameter	Type	Required	Description
`agent_id`	string	Yes	Unique agent identifier.

No request body is required.

curl -X DELETE "https://api.qoder.com.cn/api/v1/cloud/agents/agent_019eXXXX..." \
  -H "Authorization: Bearer $QODER_PAT"

HTTP 200 OK

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "deleted": true
}

Field	Type	Description
`type`	string	Always `"agent"`.
`id`	string	Unique identifier of the deleted agent.
`deleted`	boolean	Always `true` on success.

HTTP	Type	Trigger
401	`TOKEN_INVALID`	The PAT is invalid, missing, or malformed.
403	`permission_error`	Caller lacks permission to delete this agent. An admin role may be required.
404	`not_found_error`	No agent exists with the given ID, or it has already been deleted.

See Errors for the full error envelope.

Deletion is permanent and cannot be undone.
To temporarily disable an agent instead, use Archive an agent.
Deleting an already-archived agent is allowed.
Calling DELETE again on the same ID returns 404.
Some deployments require additional admin permissions (the x-gw-roles: admin header); insufficient permissions return 403.

Confirm that the agent has no active sessions running.
If you are not sure whether permanent deletion is needed, archive the agent first.
Back up the agent configuration through the version history endpoint before deleting.