# Build conversation context

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

Assembles conversation context from memory (default sources: episodic, semantic; include stm in enabled_sources for recent turns). The project scope is carried by the route id path parameter and the org is derived from that project. Provide a non-empty query (typically the latest user message) and the user_id whose memory to assemble.


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


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **id** (string)
  Project ID



### Body: application/json (object)
Context build request
- **enabled_sources** (array[string])
  EnabledSources selects memory sources (stm, episodic, semantic, taxonomic,
  procedural); omitted defaults to episodic, semantic.

- **format_style** (string)

- **include_memories** (boolean)

- **max_tokens** (integer)
  MaxTokens is the gross context-construction budget (not a fetch cost).
  After retrieval and ranking the memory server subtracts a 500-token
  formatting reserve, then greedily selects whole memory chunks that fit.
  Positive values at or below 500 leave no budget for memories. Values
  above 500 can still yield empty context when no chunk fits.

- **metadata_filter** (object)

- **model_type** (string)

- **query** (string)

- **query_embedding** (array[number])

- **session_id** (string)

- **similarity_threshold** (number)

- **top_k** (integer)

- **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
Assembled context payload

#### Body: application/json (object)
object
### 400
Invalid request body, missing user_id/query, or top_k outside 1-200

#### 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)