# Search memory

**POST /api/v1/projects/{id}/memory/search**

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.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers

- **Idempotency-Key** (string)
  Accepted but ignored — search is read-only (no dedup)


### Path parameters

- **id** (string)
  Project ID



### Body: application/json (object)
Search request with type, query, and user_id (type-specific fields allowed)
- **dedup_threshold** (number)

- **deduplicate** (boolean)

- **domain** (string)

- **metadata_filter** (object)

- **query** (string)

- **rank** (boolean)

- **session_id** (string)

- **similarity_threshold** (number)

- **tags** (array[string])

- **top_k** (integer)

- **type** (string)

- **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.

#### Body: application/json (object)
- **badRequestDetail** (object)
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

- **detail** (string)
  Human-readable error details.

- **error** (integer)
  HTTP status code.

- **errorCode** (string)
  Machine-readable error code.

- **parameters** (array[string])
  Request parameter names associated with the error; omitted when none apply.

- **reason** (string)
  HTTP status reason phrase.


### 200
Search results

#### Body: application/json (object)
object
### 400
Invalid type, missing type, disallowed fields, or top_k outside 1-500

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 401
Missing or invalid credentials

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 403
Caller lacks read access to the project

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 500
Internal error

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 502
Memory service unreachable

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)