Delete Agent
Delete an agent configured for your workspace.
Deletes an agent by its numeric id, scoped to the workspace. The agent is archived and stops monitoring immediately; signals it already surfaced are preserved. Returns 404 when the agent does not exist.
Delete agent
DELETE/api/v2/agents/:agent_id
Path parameters
| Parameter | Type | Description |
|---|---|---|
| agent_id | integer | Identifier of the agent. |
Example request
curl -X DELETE "https://api.getsillage.com/api/v2/agents/42" \
-H "Authorization: Bearer $SILLAGE_API_KEY"Example response
{
"data": {
"id": 42
}
}Response fields
| Field | Type | Description |
|---|---|---|
| data.id | integer | Identifier of the deleted agent. |
Errors
| Status | Description |
|---|---|
| 401 | The API key is missing or invalid. |
| 404 | The agent does not exist. |
| 422 | Invalid agent_id — must be a positive integer. |