Search Documentation
Search across all documentation pages
ingest_turn
Push a conversation turn for automatic fact extraction. ExoVault will run signal detection and, if the turn contains extractable knowledge, queue it for background LLM extraction. Use this to capture important conversation exchanges that should become durable memories. Only available in gateway mode.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| content | string (1-100,000 chars) | required | The conversation turn content (plaintext) |
| role | string | required | Who said this: user or assistant |
| vaultId | string (UUID) | optional | Vault to scope the turn to. Defaults to defaultVaultId. |
| agentId | string | optional | Agent identifier |
| agentRunId | string | optional | Agent run/session ID |
Returns#
Confirmation of ingestion with signal detection results indicating whether the turn was queued for extraction.
Example#
json
{
"tool": "ingest_turn",
"arguments": {
"content": "We decided to use PostgreSQL for all database needs going forward. MySQL is no longer approved for new projects.",
"role": "user"
}
}