NOnovu
Agents

Delete an agent

Changed on

Delete an agent by identifier, remove all agent-integration links, and clear the agent assignment from any workflows that reference it. 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}

Request

  • Base URL
    https://api.novu.co
  • Auth
    API key in header Authorization

Path parameters

identifierstring required

Query parameters

deleteFromProviderstring required

Headers

idempotency-keystring

A header for idempotency purposes

Response

The agent was deleted.

Changes