---
title: "Changes to POST /api/v1/{context_id}/query"
method: POST
path: "/api/v1/{context_id}/query"
---

# Changes to POST /api/v1/{context_id}/query

`POST /api/v1/{context_id}/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 5 revisions.

- **2026-08-24** `9f1598713067`: 4 warning, 8 info
- **2026-06-16** `52b41ab517b6`: 2 breaking, 4 warning, 2 info
- **2026-06-16** `6ad06b1fefc4`: 1 breaking
- **2026-06-08** `741d58b9ef89`: 3 breaking, 1 warning, 5 info

## Changes

- **2026-08-24** `9f1598713067`: 4 warning, 8 info
  - added the new `action` enum value to the `hits/items/source` response property for the response status `200`
  - added the new `escalated` enum value to the `tier` response property for the response status `200`
  - added the new `escalated` enum value to the `trace/resolutionTier` response property for the response status `200`
  - added the new `turn` enum value to the `hits/items/source` response property for the response status `200`
  - added the non-success response with the status `503`
  - added the optional property `contextHits` to the response with the `200` status
  - added the optional property `hits/items/dateNotes` to the response with the `200` status
  - added the optional property `hits/items/occurredAt` to the response with the `200` status
  - added the optional property `hits/items/resource` to the response with the `200` status
  - added the optional property `queryWindow` to the response with the `200` status
  - removed the `full_context` enum value from the `tier` response property for the response status `200`
  - removed the `full_context` enum value from the `trace/resolutionTier` response property for the response status `200`
- **2026-06-16** `52b41ab517b6`: 2 breaking, 4 warning, 2 info
  - the request property `mode` became not nullable
  - the `mode` request property type changed from `string, null` to no type
  - added the new `cache` enum value to the `trace/resolutionTier` response property for the response status `200`
  - added the new `direct` enum value to the `trace/resolutionTier` response property for the response status `200`
  - added the new `full_context` enum value to the `trace/resolutionTier` response property for the response status `200`
  - added the new `hybrid` enum value to the `trace/resolutionTier` response property for the response status `200`
  - added the new optional request property `includeDuplicates`
  - added `#/components/schemas/MemoryQueryMode, subschema #1` to the `mode` request property `oneOf` list
- **2026-06-16** `6ad06b1fefc4`: 1 breaking
  - the `lens/items/` request property type changed from `string` to `array`
- **2026-06-08** `741d58b9ef89`: 3 breaking, 1 warning, 5 info
  - removed `#/components/schemas/MemoryQueryMode, subschema #1` from the `mode` request property `oneOf` list
  - the `lens/items/` request property type changed from `array` to `string`
  - the `mode` request property type changed from no type to `string, null`
  - removed the request property `includeDuplicates`
  - the request property `mode` became nullable
  - removed the `cache` enum value from the `trace/resolutionTier` response property for the response status `200`
  - removed the `direct` enum value from the `trace/resolutionTier` response property for the response status `200`
  - removed the `full_context` enum value from the `trace/resolutionTier` response property for the response status `200`
  - removed the `hybrid` enum value from the `trace/resolutionTier` response property for the response status `200`

---

[Operation](https://skmtc.dev/surrealdb/apis/spectron/docs/api/v1/:context_id/query/post.md) - [API](https://skmtc.dev/surrealdb/apis/spectron.md) - [Page](https://skmtc.dev/surrealdb/apis/spectron/changes/api/v1/:context_id/query/post)