Skip to content

Forget an entire scope

View .md
DELETE

Delete every fact in one scope. Returns immediately; the purge runs in batches in the background, so a list right afterwards can still show rows.

This does not touch collections — DELETE /v1/memory/collections/{collection} does that.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Query parameters

  • scopestring

    Which scope to address: contact:<contactId>, conversation:<conversationId>, or omitted for the project scope.

    Note the asymmetry with POST /v1/memory and POST /v1/memory/search, which take the scope in the request BODY as scope plus contactId/conversationId. Every other Memory endpoint takes it here.

Responses

202Purge scheduled.
  • statusstringrequired
400Invalid scope.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject