> ## Documentation Index
> Fetch the complete documentation index at: https://hub.hcompany.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete an agent

> Remove an agent from your catalog.

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

<ParamField path="agent_name" type="string" required>
  The agent's `name` (e.g. `my-research-bot` or `myorg/web-helper`). Slash-containing names are supported.
</ParamField>

***

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE https://agp.eu.hcompany.ai/api/v2/agents/my-research-bot \
    -H "Authorization: Bearer $HAI_API_KEY"
  ```

  ```python Python theme={null}
  from hai_agents import Client

  client = Client()

  client.agents.delete_agent(agent_name="my-research-bot")
  ```

  ```typescript TypeScript theme={null}
  import { HaiAgentsClient } from "hai-agents";

  const client = new HaiAgentsClient();

  await client.agents.deleteAgent({ agentName: "my-research-bot" });
  ```
</CodeGroup>

***

## Errors

| Status | Cause                                       |
| ------ | ------------------------------------------- |
| `403`  | The agent is reserved (`h/`) and read-only. |
| `404`  | Agent not found or you don't have access.   |
