2026-08-11

GraphQL schema change log: 2026-08-11

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

[log] ✖ Directive assetMetadata was removed
[log] ✖ Directive retention was removed
[log] ✖ Directive sensitiveData was removed
[log] ✖ Directive authenticated was removed
[log] ✖ Directive requiresScopes was removed
[log] ✔ Description for enum value DescriptionFormatting.TEXT changed from:
```
Plain text. This is the default.
```
To:
```
Plain text. Default.
```
[log] ✔ Field EmployerJob.roleData description changed from:
```
All data that applies to the job role. 
```
To:
```
Role-level job data.
```

[log] ✔ Field EmployerJob.seatsConnection description changed from:

Paginated job seats. `first`: Page size. `after`: Pagination cursor.

To:

Paginated job seats. Use `first` for page size and `after` for the cursor.

[log] ✔ Description:

Standard pay is represented with this class, expressed as an amount paid per time unit.

On type EmployerJobBasePay has changed to:

Standard pay uses this class and is expressed as an amount per time unit.

[log] ✔ Field EmployerJobBasePay.payRangeMinor description changed from:
```
Pay amount in minor currency units
```
To:
```
Pay amount in minor currency units.
```
[log] ✔ Field EmployerJobBasePay.payTimeUnit description changed from:
```
Time unit corresponding 
```
To:
```
pay range to Time unit for the pay range.
```

[log] ✔ Description:

Canonical pay represents multiple forms of financial compensation offered by the employer.

On type EmployerJobCanonicalPay has changed to:

Canonical pay defines employer compensation across pay types.

[log] ✔ Field EmployerJobCanonicalPay.basePay description changed from:

Standard base pay expressed as an amount paid for a selected unit of time (e.g. hourly)

To:

Standard base pay per selected time unit (for example, hourly).

[log] ✔ Field EmployerJobCanonicalPay.currency description changed from:

[ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)-formatted currency code.

To:

[ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.

[log] ✔ Description:

Contains all role-level data for an EmployerJob. Role data can be thought of as a set of default values for every seat on the job. When a field exists at both the role and seat level, the seat data will override the role default when present.

On type EmployerJobRoleData has changed to:

Role-level data for an `EmployerJob`. Role values are defaults for all seats. When both `role` and `seat` define a field, `seat` values take precedence.

[log] ✔ Field EmployerJobRoleData.company description changed from:
```
Name of the hiring company for the job.
```
To:
```
Hiring company name.
```
[log] ✔ Field EmployerJobRoleData.metaData description changed from:
```
Various IDs and other meta data specific to the EmployerJob. 
```
To:
```
Employer job IDs and metadata.
```

[log] ✔ Description:

Contains various meta data for an [EmployerJob](/api/job/objects/EmployerJob).

On type EmployerJobRoleMetaData has changed to:

Contains metadata for an [`EmployerJob`](/api/job/objects/EmployerJob).

[log] ✔ Field EmployerJobRoleMetaData.dateCreated description changed from:
```
Creation timestamp for the EmployerJob.
```
To:
```
Creation timestamp for the `EmployerJob`.
```

[log] ✔ Field EmployerJobRoleMetaData.isExternalIntegratedJob description changed from:

Set to true when the job data originated via an external ATS system integrated with Indeed. 
False if the job came from external crawling. Null if the job was directly posted on Indeed.

To:

`true` if the job data comes from an external ATS integrated with Indeed.
`false` if it comes from external crawling. 
`null` if it is posted directly on Indeed.

[log] ✔ Description:
```
Seat for an [EmployerJob](/api/job/objects/EmployerJob).
```
On type EmployerJobSeat has changed to:
```
Seat for an [`EmployerJob`](/api/job/objects/EmployerJob).
```
[log] ✔ Field EmployerJobSeat.jobPost description changed from:
```
This seats job posting. 
```
To:
```
This seat’s job posting.
```

[log] ✔ Description:

Contains all job data available for an [EmployerJobSeat](/api/job/objects/EmployerJobSeat). If a field is not explicitly defined on the seat but the field does exist within the role data, then the role value for the field will be populated here.

On type EmployerJobSeatData has changed to:

Job data for an [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat).
If a field is missing on `seat` but exists in `role`, this object uses the `role` value.

[log] ✔ Field EmployerJobSeatData.campaignCategories description changed from:
```
IDs for grouping related seats in sponsored job campaigns.
```
To:
```
IDs that group related seats in sponsored job campaigns.
```
[log] ✔ Field EmployerJobSeatData.description description changed from:
```
Seat description formatted in SRF (Selenium Rich Format).
```
To:
```
Seat description in SRF (Selenium Rich Format).
```
[log] ✔ Field EmployerJobSeatData.location description changed from:
```
Holds all data related to where the work for a job seat will be performed.
```
To:
```
Work location for this seat.
```
[log] ✔ Field EmployerJobSeatData.metaData description changed from:
```
Various IDs and meta data specific to a seat
```
To:
```
Seat IDs and metadata.
```
[log] ✔ Field EmployerJobSeatData.pay description changed from:
```
Holds all data related to pay for the work to be performed
```
To:
```
Pay data for this seat.
```

[log] ✔ Field EmployerJobSeatData.visibilityData description changed from:

Defines when, where, and how the job seat is visible to job seekers

To:

Visibility settings for when, where, and how job seekers see this seat.

[log] ✔ Description:

Contains various meta data for an [EmployerJobSeat](/api/job/objects/EmployerJobSeat).

On type EmployerJobSeatMetaData has changed to:

Metadata for an [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat).

[log] ✔ Field EmployerJobSeatMetaData.jobKey description changed from:

Encrypted unique identifier of `jobPostId` corresponding to the seats [JobPost](/api/job/objects/EmployerJobSeat).

To:

Encrypted unique ID of the seat’s `jobPostId` for [`JobPost`](/api/job/objects/JobPost).

[log] ✔ Field EmployerJobSeatMetaData.seatPostingId description changed from:
```
Posting ID for the job seat. Also known as `referenceNumber` or `refnum`.
```
To:
```
Job seat posting ID, also called `referenceNumber` or `refnum`.
```

[log] ✔ Field EmployerJobSeatMetaData.seatRequisitionId description changed from:

Requisition ID for the job seat. Takes the first non-null value found from external job ID, `referenceNumber`, `referenceId`.

To:

Job seat requisition ID.
Uses the first non-null value from external job ID, `referenceNumber`, or `referenceId`.

[log] ✔ Description:

Contains data describing when, where, and how a job seat is visible to job seekers [EmployerJobSeat](/api/job/objects/EmployerJobSeat).

On type EmployerJobSeatVisibilityData has changed to:

Describes when, where, and how an [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) is visible to job seekers.

[log] ✔ Field EmployerJobSeatVisibilityData.externalJobPageUrl description changed from:
```
Job posting URL on a non-Indeed site, such as the employers website.
```
To:
```
Job posting URL on a non-Indeed site, such as the employer website.
```
[log] ✔ Field EmployerJobSeatVisibilityData.trackingUrl description changed from:
```
Tracking URL for the job seat.
```
To:
```
Tracking URL for this job seat.
```

[log] ✔ Description:

A page of [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) results on type EmployerJobSeatsConnection

Has changed to:

A page of [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) results.

[log] ✔ Field EmployerJobSeatsConnection.edges description changed from:

[`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) edges for this connection.

To:

Edges in this [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) connection.

[log] ✔ Field EmployerJobSeatsConnection.pageInfo description changed from:
```
This connections pagination data.
```
To:
```
Pagination data for this connection.
```

[log] ✔ Field EmployerJobSeatsConnection.seats description changed from:

[`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) results for this connection.

To:

[`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) items in this connection.

[log] ✔ Description:

Associates an [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) with a pagination cursor.

On type EmployerJobSeatsEdge has changed to:

Links an [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) to a pagination cursor.

[log] ✔ Field EmployerJobSeatsEdge.cursor description changed from:
```
This edges pagination cursor.
```
To:
```
Pagination cursor for this edge.
```

[log] ✔ Field EmployerJobSeatsEdge.node description changed from:

The [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) for this edge.

To:

[`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) for this edge.

[log] ✔ Description:

Indeeds job object view. Connects employer job data with post-level data visible to job seekers.

On type JobPost has changed to:

Indeed job view that links employer job data to post-level data shown to job seekers.

[log] ✔ Field JobPost.externalPartnerCallToAction description changed from:
```
Call to action for the job posting. 
```
To:
```
Input to request a call to action for this job posting.
```
[log] ✔ Field JobPost.id description changed from:
```
[IRI](/getstarted/iris) of the job key. 
```
To:
```
Job key [IRI](/integration-basics/graphql-at-indeed/iris).
```
[log] ✔ Description:
```
Call to action for the job posting.
```
On type JobPostCallToAction has changed to:
```
Call-to-action data for a job post.
```
[log] ✔ Field JobPostCallToAction.imageUrl description changed from:
```
Call to action image URL.
```
To:
```
Call-to-action image URL.
```
[log] ✔ Field JobPostCallToAction.statusName description changed from:
```
Call to action status.
```
To:
```
Call-to-action status.
```
[log] ✔ Description:
```
Input for a job posting call to action.
```
On type JobPostCallToActionInput has changed to:
```
Input for job posting call-to-action data.
```

[log] ✔ Input field JobPostCallToActionInput.locale description changed from:

Locale for the call to action. See [Supported language codes, country codes, and locales](/api/reference/language-and-country-codes). Unsupported locales default to `en-us`.

To:

Locale for call-to-action content.
See [Supported language codes, country codes, and locales](/api/reference/language-and-country-codes).
Unsupported locales default to `en-US`.

[log] ✔ Description:
```
Status of the call to action for a job posting.
```
On type JobPostCallToActionStatus has changed to:
```
Call-to-action status for a job post.
```
[log] ✔ Description for enum value JobPostCallToActionStatus.EXPIRED changed from:
```
The job posting has expired and is no longer searchable on Indeed. 
```
To:
```
Job posting is expired and no longer searchable on Indeed.
```
[log] ✔ Description for enum value JobPostCallToActionStatus.NEEDS_SPONSORSHIP changed from:
```
The job posting requires sponsorship to be searchable on Indeed. 
```
To:
```
Job posting requires sponsorship to be searchable on Indeed.
```
[log] ✔ Description for enum value JobPostCallToActionStatus.NOT_SEARCHABLE changed from:
```
The job posting is not searchable on Indeed for an unspecified reason. 
```
To:
```
Job posting is not searchable on Indeed for an unspecified reason.
```
[log] ✔ Description for enum value JobPostCallToActionStatus.SEARCHABLE changed from:
```
The job posting is active and searchable on Indeed. 
```
To:
```
Job posting is active and searchable on Indeed.
```
[log] ✔ Description:
```
External status types from the job posting. 
```
On type JobPostStatus has changed to:
```
External job-post status types.
```

[log] ✔ Input field JobPostStatusCommunicationSettingsInput.communicationInterfaceName description changed from:

Interface name for status messages, such as `myJobBoardName`. Combines locale and message control name.

To:

Interface name for status messages (for example, `myJobBoardName`).
Combines locale and message control name.

[log] ✔ Description:

Input for `JobPost` status. Required for GraphQL Federation.

On type JobPostStatusInput has changed to:

Input for `JobPost.status`. Required for GraphQL Federation.

[log] ✔ Input field JobPostStatusInput.surfaceContexts description changed from:
```
Surface contexts for job posting status. 
```
To:
```
Surface contexts used to evaluate status.
```
[log] ✔ Input field JobPostSurfaceContextInput.statusCommunicationSettings description changed from:
```
Translation language and message type. 
```
To:
```
Language and message-type settings.
```

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

Returns a reference to an entity that implements the Node interface by extracting its type (__typename) from the supplied id, which should be an IRI. (https://docs.indeed.com/api/common/objects/ID)

To:

Returns a reference to an entity that implements the `Node` interface by extracting its type (__typename) from the supplied [ID](/api/common/objects/ID), which is an [IRI](/getstarted/iris).

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

Returns a list of references to entities that implements the Node interface by extracting their type (__typename) from the supplied ids, which should be IRIs. (https://docs.indeed.com/api/common/objects/ID)

To:

Lists references to entities that implement the `Node` interface by extracting their type (__typename) from the supplied [IDs](/api/common/objects/ID), which are [IRIs](/getstarted/iris).

GraphQL schema change log: 2026-08-11​

Was this page helpful?

GraphQL schema change log: 2026-08-11