curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall" \
  -H "X-Session-Token: your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "user preferences",
    "limit": 10,
    "min_similarity": 0.2,
    "type": ["preference"]
  }'

{
  "agent_id": "my-agent",
  "session_id": "sess_cf824a95d305",
  "query": "user preferences",
  "memories": [
    {
      "id": "3e681f12-a28c-4d1d-9632-b8dadf1f9d0c",
      "title": "User Preference Note",
      "content": "Prefers email communication",
      "text": "[PREFERENCE] User Preference Note\n\nPrefers email communication",
      "type": "preference",
      "confidence": 0.98,
      "status": "active",
      "expired_at": null,
      "expired_by": null,
      "tags": [],
      "created_at": "2026-03-26T09:00:00.000000",
      "updated_at": "2026-03-26T09:00:00.000000",
      "actor_id": "my-agent",
      "source": "agent",
      "source_ref": null,
      "agent_id": "my-agent",
      "score": 0.086334,
      "provenance": "explicit_statement"
    }
  ],
  "count": 1
}

{
  "detail": "Missing session token. Use X-Session-Token header."
}

{
  "detail": {
    "error": "SessionExpired",
    "message": "Session has expired",
    "details": {}
  }
}

{
  "detail": [
    {
      "type": "missing",
      "loc": ["body", "query"],
      "msg": "Field required",
      "input": {}
    }
  ]
}

{
  "detail": {
    "error": "query_too_long",
    "message": "Query exceeds maximum length of 1000 characters",
    "actual_length": 1500,
    "max_length": 1000
  }
}

{
  "detail": {
    "error": "k_too_large",
    "message": "k exceeds maximum of 100",
    "actual_k": 200,
    "max_k": 100
  }
}

{
  "detail": {
    "error": "InternalServerError",
    "message": "An unexpected error occurred",
    "details": {
      "original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
    }
  }
}