2026-08-11

GraphQL schema change log: 2026-08-11

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

Removed directive assetMetadata
Removed directive retention
Removed directive sensitiveData
Removed directive authenticated
Removed directive requiresScopes
Changed the description of enum value DescriptionFormatting.TEXT from:
```
Plain text. This is the default.
```
To:
```
Plain text. Default.
```
Changed the description of field EmployerJob.roleData from:
```
All data that applies to the job role. 
```
To:
```
Role-level job data.
```

Changed the description of field EmployerJob.seatsConnection from:

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

To:

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

Changed the description of type EmployerJobBasePay from:

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

To:

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

Changed the description of field EmployerJobBasePay.payRangeMinor from:
```
Pay amount in minor currency units
```
To:
```
Pay amount in minor currency units.
```
Changed the description of field EmployerJobBasePay.payTimeUnit from:
```
Time unit corresponding 
```
To:
```
pay range to Time unit for the pay range.
```

Changed the description of type EmployerJobCanonicalPay from:

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

To:

Canonical pay defines employer compensation across pay types.

Changed the description of field EmployerJobCanonicalPay.basePay 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).

Changed the description of field EmployerJobCanonicalPay.currency 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.

Changed the description of type EmployerJobRoleData from:

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.

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.

Changed the description of field EmployerJobRoleData.company from:
```
Name of the hiring company for the job.
```
To:
```
Hiring company name.
```
Changed the description of field EmployerJobRoleData.metaData from:
```
Various IDs and other meta data specific to the EmployerJob. 
```
To:
```
Employer job IDs and metadata.
```

Changed the description of type EmployerJobRoleMetaData from:

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

To:

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

Changed the description of field EmployerJobRoleMetaData.dateCreated from:
```
Creation timestamp for the EmployerJob.
```
To:
```
Creation timestamp for the `EmployerJob`.
```

Changed the description of field EmployerJobRoleMetaData.isExternalIntegratedJob 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.

Changed the description of type EmployerJobSeat from:

Seat for an [EmployerJob](/api/job/objects/EmployerJob).

To:

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

Changed the description of field EmployerJobSeat.jobPost from:
```
This seats job posting. 
```
To:
```
This seat’s job posting.
```

Changed the description of type EmployerJobSeatData from:

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.

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.

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

Changed the description of field EmployerJobSeatData.visibilityData 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.

Changed the description of type EmployerJobSeatMetaData from:

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

To:

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

Changed the description of field EmployerJobSeatMetaData.jobKey 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).

Changed the description of field EmployerJobSeatMetaData.seatPostingId from:

Posting ID for the job seat. Also known as `referenceNumber` or `refnum`.

To:

Job seat posting ID, also called `referenceNumber` or `refnum`.

Changed the description of field EmployerJobSeatMetaData.seatRequisitionId 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`.

Changed the description of type EmployerJobSeatVisibilityData from:

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

To:

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

Changed the description of field EmployerJobSeatVisibilityData.externalJobPageUrl 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.
```
Changed the description of field EmployerJobSeatVisibilityData.trackingUrl from:
```
Tracking URL for the job seat.
```
To:
```
Tracking URL for this job seat.
```

Changed the description from:

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

To:

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

Changed the description of field EmployerJobSeatsConnection.edges from:

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

To:

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

Changed the description of field EmployerJobSeatsConnection.pageInfo from:
```
This connections pagination data.
```
To:
```
Pagination data for this connection.
```

Changed the description of field EmployerJobSeatsConnection.seats from:

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

To:

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

Changed the description of type EmployerJobSeatsEdge from:

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

To:

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

Changed the description of field EmployerJobSeatsEdge.cursor from:
```
This edges pagination cursor.
```
To:
```
Pagination cursor for this edge.
```

Changed the description of field EmployerJobSeatsEdge.node from:

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

To:

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

Changed the description of type JobPost from:

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

To:

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

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

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

Changed the description of type JobPostCallToActionStatus from:
```
Status of the call to action for a job posting.
```
To:
```
Call-to-action status for a job post.
```
Changed the description of enum value JobPostCallToActionStatus.EXPIRED from:
```
The job posting has expired and is no longer searchable on Indeed. 
```
To:
```
Job posting is expired and no longer searchable on Indeed.
```
Changed the description of enum value JobPostCallToActionStatus.NEEDS_SPONSORSHIP from:
```
The job posting requires sponsorship to be searchable on Indeed. 
```
To:
```
Job posting requires sponsorship to be searchable on Indeed.
```
Changed the description of enum value JobPostCallToActionStatus.NOT_SEARCHABLE 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.
```
Changed the description of enum value JobPostCallToActionStatus.SEARCHABLE from:
```
The job posting is active and searchable on Indeed. 
```
To:
```
Job posting is active and searchable on Indeed.
```
Changed the description of type JobPostStatus from:
```
External status types from the job posting. 
```
To:
```
External job-post status types.
```

Changed the description of input field JobPostStatusCommunicationSettingsInput.communicationInterfaceName 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.

Changed the description of type JobPostStatusInput from:

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

To:

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

Changed the description of input field JobPostStatusInput.surfaceContexts from:
```
Surface contexts for job posting status. 
```
To:
```
Surface contexts used to evaluate status.
```
Changed the description of input field JobPostSurfaceContextInput.statusCommunicationSettings from:
```
Translation language and message type. 
```
To:
```
Language and message-type settings.
```

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

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