Recall Semantic Memory

post/v1/graphs/{graph_id}/memory/recall

Part of Memory.

Ranked semantic recall over the graph's per-graph memory store. Returns scored hits in the same shape as document search.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`graph_id`required	string	Graph Id

Request body

Required, application/json.

Field	Type	Description
`query`required	string	Recall query Constraints: 1–500 characters
`k`optional	integer	Max results to return Default: `10` Constraints: 1–50
`memory_type`optional	string	Filter by memory type
`source`optional	string	Filter by source

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/graphs/{graph_id}/memory/recall" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "string"
}'

Responses

200 Successful Response

Field Type Description

totalrequired

integer

Matching documents before any grouping, as OpenSearch counts them (it stops counting at 10,000). Not the number of distinct results a grouped search can page through.

hitsrequired

SearchHit[]

A single search result with snippet. A long SEC section (an MD&A, a commitments note) is indexed in parts, each a document of its own: part of part_count, parent_document_id shared by the section's parts, next_document_id to read on. On a grouped search, also_in_filings counts the other filings of the same filer whose same section (and part) matched and were folded into this hit.

SearchHit fields

Field	Type	Description
`document_id`required	string
`score`required	number
`source_type`required	string
`parent_document_id`optional	string
`part`optional	integer	Default: `1`
`part_count`optional	integer	Default: `1`
`next_document_id`optional	string
`entity_ticker`optional	string
`entity_name`optional	string
`section_label`optional	string
`section_id`optional	string
`element_qname`optional	string
`filing_date`optional	string
`fiscal_year`optional	integer
`form_type`optional	string
`accession_number`optional	string
`xbrl_elements`optional	string[]
`snippet`required	string
`content_length`optional	integer	Default: `0`
`content_url`optional	string
`document_title`optional	string
`tags`optional	string[]
`folder`optional	string
`also_in_filings`optional	integer

queryrequired string

graph_idrequired string

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Validation Error
429	Rate limit exceeded
500	Internal server error
503	Semantic memory not available