Query records (hosted RecordStore.query)

{
  "records": [
    {
      "createdAt": "2024-06-10T09:15:30Z",
      "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
      "metadata": {},
      "name": "UserSessionRecord",
      "organizationId": "org_987654321",
      "type": "session_record",
      "updatedAt": "2024-06-10T10:00:00Z",
      "userId": "user_1234567890abcdef",
      "messages": [
        {
          "content": "Initialization complete. All systems operational.",
          "role": "system"
        }
      ],
      "metadataLabels": {},
      "metadataSchema": {},
      "productSurfaceId": "prod_123456789",
      "schemaValid": true
    }
  ]
}

Hosted fulfillment of the runtime RecordStore seam. Returns every record matching the optional type / name / chip-filter where, scoped to the authenticated caller, ordered most-recently-updated first. 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.

namestringOptional>=1 character

typestringOptional>=1 character

whereobjectOptional

Response

The matching records (dates as ISO-8601 strings)

recordslist of objects

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

$	curl -X POST https://api.runtype.com/v1/runtime/records/query \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'