curl --request DELETE \
--url 'https://api.computer.stateset.app/api/v1/custom-agents/{agent_id}' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
Delete Custom Agent V1
Delete a custom agent. Existing AgentRun rows that referenced this agent are NOT cascaded; they retain custom_agent_id for audit but lose the linked row…
DELETE
/
api
/
v1
/
custom-agents
/
{agent_id}
curl --request DELETE \
--url 'https://api.computer.stateset.app/api/v1/custom-agents/{agent_id}' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
Delete a custom agent.
Existing AgentRun rows that referenced this agent are NOT cascaded;
they retain
custom_agent_id for audit but lose the linked row.
To suspend without losing audit trail, PATCH is_active=false.
Path parameters
string (uuid)
required
Response
No response body. Successful Response.Status codes
| Code | Meaning |
|---|---|
204 | Successful Response |
422 | Validation Error |
curl --request DELETE \
--url 'https://api.computer.stateset.app/api/v1/custom-agents/{agent_id}' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
Last modified on August 31, 2026