Recall memories (hosted MemoryStore.recall)

Hosted fulfillment of the runtime MemoryStore seam. Runs the model-backed recall over the authenticated caller’s tenant-scoped profile bucket. Requires an Enterprise plan: ineligible accounts receive 403 (code BYOC_PLAN_REQUIRED).

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

profileIdstringRequired1-256 characters

querystringRequired

optionsobjectOptional

Response

Recall result

answerstring

candidateslist of objects

countdouble

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

$	curl -X POST https://api.runtype.com/v1/runtime/memory/recall \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"profileId": "user_9f8b7c6d5e4a3b2c1d0e",
>	"query": "What were the key points from my last project meeting?"
>	}'

1	{
2	"answer": "The last project meeting focused on finalizing the design specs and setting deadlines for the development phase.",
3	"candidates": [
4	{
5	"id": "recall_1234567890abcdef",
6	"score": 0.95,
7	"sessionId": "session_20240601_abc123",
8	"summary": "Summary of project meeting held on 2024-05-28 discussing design specs and deadlines."
9	}
10	],
11	"count": 1
12	}