Skip to content

Commit 08fac7a

Browse files
production introspection disable and query depth cap (desci-infra 2.0.1)
1 parent 17aa9e7 commit 08fac7a

2 files changed

Lines changed: 15 additions & 2 deletions

File tree

api-reference/changelog.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,12 @@ This page tracks breaking changes, deprecations, and additions across the Molecu
1010

1111
## Labs API
1212

13+
### GraphQL introspection disabled and query depth capped in production
14+
15+
The production endpoint (shared by all Molecule APIs — see [API Overview](README.md)) no longer serves `__schema` / `__type` introspection queries: they now return a validation error. `__typename` still resolves. Selection-set depth is also capped at 10 in production, with scalar leaves counted as a level (`{ root { child { name } } }` is depth 3). A query beyond that limit fails at execution time with `errorType: "QueryDepthLimitReached"` and partial data — a plain GraphQL error, not the catalogued error shape used elsewhere, so handle both.
16+
17+
**Migration:** If your codegen or tooling discovers the schema by introspecting the production endpoint, that now fails — request a current copy of the schema from the Molecule team (see [Getting Support](README.md)) rather than introspecting production. If you see `QueryDepthLimitReached`, flatten the query to 10 levels of nesting or fewer; this limit was not previously enforced.
18+
1319
### `*V2` operations and pre-OCL naming removed
1420

1521
The legacy `*V2` operations and the pre-OCL naming have been **removed**. The current API is `oclId`-based. If you are migrating from an older integration, use the current names below.

release-notes/labs-api.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,15 @@ icon: flask
88
Changes to the [Labs API](../api-reference/labs-api/README.md) that affect integrations. Versions not
99
listed shipped nothing consumer-visible.
1010

11-
_No entries yet._ Entries are added per release by the docs-sync pipeline; see
12-
[Overview](README.md) for the format.
11+
## 2.0.1
12+
13+
_Released 2026-08-18_
14+
15+
### Breaking changes
16+
17+
#### GraphQL introspection disabled and query depth capped in production
18+
19+
The production endpoint no longer serves `__schema` / `__type` introspection queries — they return a validation error. `__typename` still resolves. Selection-set depth is also capped at 10 in production; a query beyond that fails at execution time with `errorType: "QueryDepthLimitReached"` rather than the usual error shape. See [API Changelog & Migration](../api-reference/changelog.md#graphql-introspection-disabled-and-query-depth-capped-in-production) for details and migration steps.
1320

1421
For migrations off the pre-OCL naming and the `*V2` operations, see
1522
[API Changelog & Migration](../api-reference/changelog.md).

0 commit comments

Comments
 (0)