2026-03-19

GraphQL schema change log: 2026-03-19

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

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

Changed the description of enum value MdsResponseCode.FORBIDDEN 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.

Changed the description of enum value MdsResponseCode.UNAUTHENTICATED 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.

Changed the description of field Query.classifyOccupationsForJobDetails 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.

Changed the description of type RelatedTaxonomyConceptsInput from:

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

To:

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

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

Changed the description of field TaxonomyConcept.key from:

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

To:

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

Changed the description of field TaxonomyConcept.uuid from:

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

To:

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

Changed the description of type TaxonomyConceptType from:
```
Types of taxonomy concepts.
```
To:
```
Types of concepts.
```

Changed the description of enum value TaxonomyConceptType.COMPANY_SECTOR 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).

Changed the description of type TaxonomyConceptsInput from:

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

To:

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

Changed the description of input field TaxonomyConceptsInput.global 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`.

Changed the description of field TaxonomyConceptsPayload.taxonomyConcepts 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