v4

latestOpenAPI 3.0.0MIT2026-07-311494532.1 MB
Agents

Delete an agent

Delete an agent by identifier and remove all agent-integration links. For managed-runtime agents, pass deleteFromProvider=true to also archive the agent on the provider side (e.g. Anthropic). By default only the Novu record is deleted and the provider agent is left intact.

delete/v1/agents/{identifier}

Path parameters

identifierstring required

Query parameters

deleteFromProviderstring required

Headers

idempotency-keystring

A header for idempotency purposes

Response

The agent was deleted.