Agents

Delete an AI Agent that belongs to an app (v2, tenant actor)

Deletes an agent owned by the App's side: the App's creator, the App itself, or its parent tenant App (agents created with a B2B Server JWT are owned by the tenant App). Agents are account-level, so deleting an App never deletes them; this is how automation that creates agents for an App cleans up after itself. Any other agent, and platform-owned agents, read as 404. Same effects as DELETE /v2/agents/{idOrAddress}. Supports User JWT and B2B Server JWT.

delete/v2/apps/{appId}/agents/{idOrAddress}

Request

  • Base URL: https://api.chat.ethora.com
  • URL: https://api.chat.ethora.com/v2/apps/{appId}/agents/{idOrAddress}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

appIdstring required

Target App ID. Must be an app the calling actor owns or has been delegated access to.

idOrAddressstring required

Agent id, or the agent's 0x... address.

Response 

{ ok: true, knowledgeDeleted?: { sites: number|null, docs: number|null, chunks: number|null } }

Changes

No recorded changes to this operation across all 1 revision of this API.