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
`k`optional	integer	Max results to return Default: `10`
`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

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.

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
`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

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