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

# Delete Agent

> Remove an ARKOS agent and its associated memory

## DELETE /v1/agents/{agent_id}

**Coming soon!** This endpoint will delete an ARKOS agent and optionally its associated memory data.

### Planned Features

* Safe agent termination
* Memory export before deletion
* Cascade deletion of related resources
* Confirmation requirements for data loss prevention

### Example Request

```bash theme={null}
curl -X DELETE "http://localhost:8000/v1/agents/test-agent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "preserve_memory": false,
    "export_data": true
  }'
```

### Example Response (Planned)

```json theme={null}
{
  "id": "test-agent",
  "status": "deleted",
  "memory_exported": true,
  "export_location": "/exports/test-agent_2024-01-15.json",
  "deleted_at": "2024-01-15T14:35:00Z"
}
```

### Parameters

| Parameter        | Type    | Required | Description                                          |
| ---------------- | ------- | -------- | ---------------------------------------------------- |
| agent\_id        | string  | Yes      | The unique identifier of the agent to delete         |
| preserve\_memory | boolean | No       | Whether to preserve memory data after agent deletion |
| export\_data     | boolean | No       | Export agent data before deletion                    |

<Warning>
  This endpoint is not yet implemented. Agent management features are planned for a future release.
</Warning>