v10

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-0582185581.9 KB
Agents

Delete an agent conversation

Soft-deletes an agent conversation owned by the authenticated user.

The controller scopes the lookup by _id, orgId, userId, and agentKey. If no matching writable conversation is found, the route is intentionally a no-op and still returns HTTP 200 with conversation: null.

This makes the operation idempotent:

  • deleting a nonexistent conversation returns success with null
  • deleting through a different agentKey returns success with null
  • deleting an already deleted conversation returns success with null
delete/agents/{agentKey}/conversations/{conversationId}

Path parameters

agentKeystring required
conversationIdstring objectId required

Response

Conversation deleted or no-op delete completed successfully

message'Conversation deleted successfully' required