About this tool

The IteraTools Vector Memory Clear API deletes all documents stored in a namespace. This is useful for resetting agent memory between sessions, clearing outdated knowledge bases, or managing namespace lifecycle. The operation is irreversible — all vectors in the namespace are permanently deleted. Only your own namespaces (scoped to your API key) can be cleared.

Quick Start

curl -X DELETE https://api.iteratools.com/memory/clear \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"namespace": "my-agent"}'

Response

{
  "ok": true,
  "data": {
    "deleted": 42,
    "namespace": "my-agent"
  }
}

Python Example

import requests

def memory_clear(namespace: str, api_key: str) -> dict:
    res = requests.delete(
        "https://api.iteratools.com/memory/clear",
        headers={"Authorization": f"Bearer {api_key}"},
        json={"namespace": namespace}
    )
    return res.json()

# Reset agent memory at the start of a new session
result = memory_clear("session-abc123", "YOUR_KEY")
print(f"Cleared {result['data']['deleted']} documents from {result['data']['namespace']}")

# Clear all user-specific namespaces
for ns in ["user-facts", "user-history", "user-preferences"]:
    r = memory_clear(ns, "YOUR_KEY")
    print(f"{ns}: deleted {r['data']['deleted']} docs")

Request Body

namespace

string (required)

Namespace to clear (all documents deleted)

Details

Endpoint	DELETE /memory/clear
Price	$0.001 / request
Effect	⚠️ Irreversible — all namespace vectors deleted
Isolation	Per API key (only your namespaces accessible)
Auth	Bearer token or x402 micropayment
Base URL	https://api.iteratools.com

Use Cases

🔄 Session reset — clear agent memory between user sessions
🗃️ Namespace lifecycle — delete stale or outdated knowledge bases
🧪 Testing — reset test namespaces between test runs
👤 Data deletion — comply with "forget me" requests
♻️ Re-indexing — clear before re-loading updated documents

Full Documentation Memory Upsert → Memory Search → Browse All Tools