Skip to main content
DELETE
/
api
/
v2
/
agents
/
{agent_name}
Delete an agent
curl --request DELETE \
  --url https://agp.eu.hcompany.ai/api/v2/agents/{agent_name} \
  --header 'Authorization: Bearer <token>'
Removes an agent from your catalog. Sessions already running against it are unaffected; new sessions can no longer reference it by name. Returns 204 No Content on success.

Path parameters

agent_name
string
required
The agent’s name (e.g. my-research-bot or myorg/web-helper). Slash-containing names are supported.

Examples

curl -X DELETE https://agp.eu.hcompany.ai/api/v2/agents/my-research-bot \
  -H "Authorization: Bearer $H_API_KEY"

Errors

StatusCause
403The agent is reserved (h/) and you are not an H employee.
404Agent not found or you don’t have access.