Return a ranked menu of items — entities, neighborhoods, temporal regions, behaviors, co-occurrences — that are relevant to the current question. Use this as the first step of an agentic retrieval flow: the caller picks an item and proceeds to /interpret (for a macro-level brief) or /search (for a deep synthesized answer).
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Input for the discovery menu endpoint.
Current question. Typically the last user message in the conversation.
1 - 5000Optional prior turns, oldest → newest. Server caps to the last 20 turns.
Storage project id to scope the retrieval against. Omit to span the entire sandbox.
YYYY-MM-DD anchor for time-relative phrasing like 'last week'.
Ranked menu of candidate context items for the query.
Ranked discovery items. Ordered by score descending — the caller picks one or more and passes their canonical_ids tuples to /interpret.
Number of items in items. Convenience mirror so callers don't have to measure the array.
Echo of the sandbox this discovery ran against.
Echo of the caller's query — useful when correlating async results without client-side state.
Markdown title + description orienting the caller on what this response contains and how to use it.
Echo of the project scope used, or null when the request spanned the full sandbox.
Short actionable pointer for what to do after picking items.