---
title: "Changes to Run an ad-hoc OpalQuery"
method: POST
path: "/queries/run"
---

# Changes to Run an ad-hoc OpalQuery

`POST /queries/run`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 43 revisions.

- **2026-10-16** `19eb12e49e4a`: 9 info
- **2026-10-06** `c0ce333f6196`: 3 warning, 27 info
- **2026-09-22** `4d9dca40a76c`: 1 warning, 9 info
- **2026-09-19** `3e78facda4c5`: 6 warning, 63 info
- **2026-09-15** `afb90e6ded01`: 2 breaking, 6 info
- **2026-08-28** `16339a4fd3c7`: 1 warning, 9 info
- **2026-08-16** `35a0d1b09a5d`: 9 info
- **2026-07-31** `bf9449da943d`: 12 info
- **2026-07-27** `b3e142c0832a`: 1 breaking, 3 info
- **2026-07-12** `327ea741c867`: 1 info

## Changes

- **2026-10-16** `19eb12e49e4a`: 9 info
  - added the new optional request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityTagKey`
  - added the new optional request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityTagKey`
  - added the new optional request property `oneOf[subschema #1: Node]/query/nodeFilters/entityTagKey`
  - added the new optional request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityTagKey`
  - added the new optional request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityTagKey`
  - added the new optional request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityTagKey`
  - added the new optional request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityTagKey`
  - added the new optional request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityTagKey`
  - added the new optional request property `oneOf[subschema #2: Access]/query/principalFilter/entityTagKey`
- **2026-10-06** `c0ce333f6196`: 3 warning, 27 info
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #1: Node]/query/nodeFilters/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY` enum value to the request property `oneOf[subschema #2: Access]/query/principalFilter/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #1: Node]/query/nodeFilters/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TARGET` enum value to the request property `oneOf[subschema #2: Access]/query/principalFilter/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #1: Node]/query/nodeFilters/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `AWS_AGENTCORE_GATEWAY_TOOL` enum value to the request property `oneOf[subschema #2: Access]/query/principalFilter/entityItemTypes/items/`
- **2026-09-22** `4d9dca40a76c`: 1 warning, 9 info
  - added the new `DATABRICKS_MCP_SERVER` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #1: Node]/query/nodeFilters/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_MCP_SERVER` enum value to the request property `oneOf[subschema #2: Access]/query/principalFilter/entityItemTypes/items/`
- **2026-09-19** `3e78facda4c5`: 6 warning, 63 info
  - added the new `DATABRICKS_CATALOG` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `DATABRICKS_FUNCTION` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `DATABRICKS_MODEL` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `DATABRICKS_SCHEMA` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `DATABRICKS_SERVICE` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `DATABRICKS_VOLUME` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new optional request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityDescription`
  - added the new optional request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityDescription`
  - added the new optional request property `oneOf[subschema #1: Node]/query/nodeFilters/entityDescription`
  - added the new optional request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityDescription`
  - added the new optional request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityDescription`
  - added the new optional request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityDescription`
  - added the new optional request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityDescription`
  - added the new optional request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityDescription`
  - added the new optional request property `oneOf[subschema #2: Access]/query/principalFilter/entityDescription`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #1: Node]/query/nodeFilters/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_CATALOG` enum value to the request property `oneOf[subschema #2: Access]/query/principalFilter/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #1: Node]/query/nodeFilters/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_FUNCTION` enum value to the request property `oneOf[subschema #2: Access]/query/principalFilter/entityItemTypes/items/`
  - added the new `DATABRICKS_MODEL` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_MODEL` enum value to the request property `oneOf[subschema #1: Node]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_MODEL` enum value to the request property `oneOf[subschema #1: Node]/query/nodeFilters/entityItemTypes/items/`
  - added the new `DATABRICKS_MODEL` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `DATABRICKS_MODEL` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `DATABRICKS_MODEL` enum value to the request property `oneOf[subschema #2: Access]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `DATABRICKS_MODEL` enum value to the request property `oneOf[subschema #2: Access]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - …29 more
- **2026-09-15** `afb90e6ded01`: 2 breaking, 6 info
  - removed `#/components/schemas/OpalAccessPathQuery` from the request body `oneOf` list
  - added `#/components/schemas/OpalAccessQueryResults` to the response body `oneOf` list for the response status `200`
  - added `ACCESS` mapping keys to the request discriminator
  - removed `ACCESS_PATH` mapping keys from the request discriminator
  - added `#/components/schemas/OpalAccessQuery` to the request body `oneOf` list
  - added `ACCESS` mapping keys to the response discriminator for the response status `200`
  - removed `ACCESS_PATH` mapping keys from the response discriminator for the response status `200`
  - removed `#/components/schemas/OpalAccessPathQueryResults` from the response body `oneOf` list for the response status `200`
- **2026-08-28** `16339a4fd3c7`: 1 warning, 9 info
  - added the new `GCP_BILLING_ACCOUNT` enum value to the `oneOf[#/components/schemas/OpalNodeQueryResults]/edges/items/node/entityItemType` response property for the response status `200`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementFilter/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalAccessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalAccessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalFilter/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/hasAccessTo/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/isAccessibleBy/entityItemTypes/items/`
  - added the new `GCP_BILLING_ACCOUNT` enum value to the request property `oneOf[#/components/schemas/OpalNodeQuery]/query/nodeFilters/entityItemTypes/items/`
- **2026-08-16** `35a0d1b09a5d`: 9 info
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementAccessFilters/hasAccessTo/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementAccessFilters/isAccessibleBy/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementFilter/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalAccessFilters/hasAccessTo/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalAccessFilters/isAccessibleBy/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalFilter/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/hasAccessTo/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/isAccessibleBy/entityName/stringMatchType`
  - added the new `REGEX` enum value to the request property `oneOf[#/components/schemas/OpalNodeQuery]/query/nodeFilters/entityName/stringMatchType`
- **2026-07-31** `bf9449da943d`: 12 info
  - added the new optional request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementAccessFilters`
  - added the new optional request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementFilter/entityAdminOwner`
  - added the new optional request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/entitlementFilter/hrIdpStatus`
  - added the new optional request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalAccessFilters`
  - added the new optional request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalFilter/entityAdminOwner`
  - added the new optional request property `oneOf[#/components/schemas/OpalAccessPathQuery]/query/principalFilter/hrIdpStatus`
  - added the new optional request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/hasAccessTo/entityAdminOwner`
  - added the new optional request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/hasAccessTo/hrIdpStatus`
  - added the new optional request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/isAccessibleBy/entityAdminOwner`
  - added the new optional request property `oneOf[#/components/schemas/OpalNodeQuery]/query/accessFilters/isAccessibleBy/hrIdpStatus`
  - added the new optional request property `oneOf[#/components/schemas/OpalNodeQuery]/query/nodeFilters/entityAdminOwner`
  - added the new optional request property `oneOf[#/components/schemas/OpalNodeQuery]/query/nodeFilters/hrIdpStatus`
- **2026-07-27** `b3e142c0832a`: 1 breaking, 3 info
  - added `#/components/schemas/OpalAccessPathQueryResults` to the response body `oneOf` list for the response status `200`
  - added `ACCESS_PATH` mapping keys to the request discriminator
  - added `#/components/schemas/OpalAccessPathQuery` to the request body `oneOf` list
  - added `ACCESS_PATH` mapping keys to the response discriminator for the response status `200`
- **2026-07-12** `327ea741c867`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/opal/apis/opal-api/docs/queries/run/post.md) - [API](https://skmtc.dev/opal/apis/opal-api.md) - [Page](https://skmtc.dev/opal/apis/opal-api/changes/queries/run/post)