---
title: "Delete agent"
method: DELETE
path: "/v1/agents/{agent_id}"
tags: ["Agents"]
---

# Delete agent

`DELETE /v1/agents/{agent_id}`

## Path parameters

- `agent_id` union, required — The agent ID (a UUID), or `notion_ai` for the personal agent. The personal agent cannot be deleted.
  - string
  - 'notion_ai' | '33333333-3333-3333-3333-333333333333' — One of: `notion_ai`, `33333333-3333-3333-3333-333333333333`

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- object
  - `agent_id` string, uuid, required
  - `status` 'deleted', required — Always "deleted": the agent has been soft-deleted (recoverable).
  - `deleted_at` string, required — ISO 8601 timestamp of when the agent was deleted.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/dee5763763b0/schema)