POST /api/v1/projects/{id}/memory/search
Bearer auth

Searches long-term memory by type (semantic, episodic, procedural, or taxonomic). The project scope is carried by the route id path parameter and the org is derived from that project. The type selects the retrieval endpoint; per-type field validation rejects fields the target type does not accept.

Headers

  • Idempotency-Key string

    Accepted but ignored — search is read-only (no dedup)

Path parameters

  • id string Required

    Project ID

application/json

Body Required

Search request with type, query, and user_id (type-specific fields allowed)

  • dedup_threshold number
  • deduplicate boolean
  • domain string
  • metadata_filter object

    Additional properties are allowed.

  • query string Required
  • rank boolean
  • session_id string
  • similarity_threshold number
  • tags array[string]
  • top_k integer

    Minimum value is 1, maximum value is 500.

  • type string Required
  • user_id string
  • visibility string

Responses

  • 406

    Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.
  • 200

    Search results
  • 400

    Invalid type, missing type, disallowed fields, or top_k outside 1-500

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 401

    Missing or invalid credentials

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 403

    Caller lacks read access to the project

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 500

    Internal error

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 502

    Memory service unreachable

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
POST /api/v1/projects/{id}/memory/search 
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/memory/search' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --header "Idempotency-Key: string" \
 --data '{
  "dedup_threshold": 42.0,
  "deduplicate": true,
  "domain": "string",
  "metadata_filter": {},
  "query": "string",
  "rank": true,
  "session_id": "string",
  "similarity_threshold": 42.0,
  "tags": [
    "string"
  ],
  "top_k": 42,
  "type": "string",
  "user_id": "string",
  "visibility": "string"
}'
Request examples 
# Headers
Idempotency-Key: string

# Payload
{
  "dedup_threshold": 42.0,
  "deduplicate": true,
  "domain": "string",
  "metadata_filter": {},
  "query": "string",
  "rank": true,
  "session_id": "string",
  "similarity_threshold": 42.0,
  "tags": [
    "string"
  ],
  "top_k": 42,
  "type": "string",
  "user_id": "string",
  "visibility": "string"
}
Response examples (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Response examples (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Response examples (200) 
{}
Response examples (200) 
{}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}