2026-03-19

GraphQL schema change log: 2026-03-19

📘 Documentation: Updated the GraphQL schema and the GraphQL API Reference with these changes:

[log] ✔ Description:
```
Input for the [`classifyOccupationsForJobDetails`](/api/occupational_metadata/queries/classifyOccupationsForJobDetails) query. Returns occupations that match the job details.
```
On type ClassifyOccupationsForJobDetailsInput has changed to:
```
Input for the [`classifyOccupationsForJobDetails`](/api/occupational_metadata/queries/classifyOccupationsForJobDetails) query. Gets occupations matching the job details.
```
[log] ✔ Description:
```
Filters taxonomy concepts by custom class.
```
On type CustomClassFilterInput has changed to:
```
Filters concepts by custom class.
```
[log] ✔ Input field CustomClassFilterInput.operation description changed from:
```
Operator for custom class filtering. Default is `AND`.
```
To:
```
Operator for custom class filtering. Default: `AND`.
```
[log] ✔ Description:
```
Taxonomy concepts grouped by common feature or use case.
```
On type CustomTaxonomyClass has changed to:
```
Concepts grouped by common feature or use case.
```

[log] ✔ Description for enum value MdsResponseCode.FORBIDDEN changed from:

Valid authentication credentials are present but are insufficient to perform the associated operation. This error code is the GraphQL equivalent of the HTTP [`403 Forbidden`](https://developer.mozilla.org/docs/Web/HTTP/Status/403) response status code.

To:

Valid authentication credentials are present but are insufficient to perform the associated operation. This error code is the GraphQL equivalent of the HTTP [`403 Forbidden`](https://developer.mozilla.org/docs/Web/HTTP/Status/403) status code.

[log] ✔ Description for enum value MdsResponseCode.UNAUTHENTICATED changed from:

The request lacked sufficient authentication credentials for the operation. The operation was not attempted. This error code is the GraphQL equivalent of the HTTP [`401 Unauthorized`](https://developer.mozilla.org/docs/Web/HTTP/Status/401) response status code.

To:

The request lacked sufficient authentication credentials for the operation. The operation was not attempted. This error code is the GraphQL equivalent of the HTTP [`401 Unauthorized`](https://developer.mozilla.org/docs/Web/HTTP/Status/401) status code.

[log] ✔ Field Query.classifyOccupationsForJobDetails description changed from:

Returns occupations that match the specified job details. Add more input for higher-quality results.

To:

Gets occupations matching the specified job details. Add more input for higher-quality results.

[log] ✔ Description:

Input for the [`relatedTaxonomyConcepts`](/api/occupational_metadata/queries/relatedTaxonomyConcepts) query. Returns concepts with the specified relationship to a concept.

On type RelatedTaxonomyConceptsInput has changed to:

Input for the [`relatedTaxonomyConcepts`](/api/occupational_metadata/queries/relatedTaxonomyConcepts) query. Gets concepts with the specified relationship to a concept.

[log] ✔ Input field RelatedTaxonomyConceptsInput.conceptId description changed from:
```
SUID or UUID of a taxonomy concept. Required.
```
To:
```
SUID or UUID of a concept. Required.
```
[log] ✔ Field RelatedTaxonomyConceptsPayload.taxonomyConcepts description changed from:
```
Taxonomy concepts matching the query input.
```
To:
```
Concepts matching the query input.
```
[log] ✔ Input field TaxonomyAttributesForJobDataInput.company description changed from:
```
Name of the company associated with the job.
```
To:
```
Company name for the job.
```
[log] ✔ Field TaxonomyConcept.definitions description changed from:
```
Definitions of the taxonomy concept.
```
To:
```
Definitions for the concept.
```

[log] ✔ Field TaxonomyConcept.key description changed from:

Short unique identifier (SUID) of the taxonomy concept. Primary key.

To:

Short unique ID (SUID) of the taxonomy concept. Primary key.

[log] ✔ Field TaxonomyConcept.uuid description changed from:

Universal unique identifier (UUID) of the taxonomy concept. Prefer `key` instead.

To:

Universal unique ID (UUID) of the taxonomy concept. Prefer `key` instead.

[log] ✔ Description:
```
Types of taxonomy concepts.
```
On type TaxonomyConceptType has changed to:
```
Types of concepts.
```

[log] ✔ Description for enum value TaxonomyConceptType.COMPANY_SECTOR changed from:

Describes a companys primary business, commonly called *industry*.

**Example**: Aerospace & Defense

For a list of company sectors, see [Company sectors](/employers/reference/company-sector).

To:

Companys primary business, commonly called *industry*.

**Example**: Aerospace & Defense

See [Company sectors](/employers/reference/company-sector).

[log] ✔ Description:

Input for the [`taxonomyConcepts`](/api/occupational_metadata/queries/taxonomyConcepts) query. Returns concepts matching one or more filters.

On type TaxonomyConceptsInput has changed to:

Input for the [`taxonomyConcepts`](/api/occupational_metadata/queries/taxonomyConcepts) query. Gets concepts matching one or more filters.

[log] ✔ Input field TaxonomyConceptsInput.global description changed from:

Include concepts that dont apply to the country and language codes. Default: `false`.

To:

Whether to include concepts that do not apply to the country and language codes. Default: `false`.

[log] ✔ Field TaxonomyConceptsPayload.taxonomyConcepts description changed from:
```
Taxonomy concepts details.
```
To:
```
Concepts details.
```

GraphQL schema change log: 2026-03-19​

Was this page helpful?

GraphQL schema change log: 2026-03-19