2026-08-11
Updated the GraphQL schema and the GraphQL API Reference with these changes:
Job Sync API
#Documentation(1)
Documentation
- Changed the description of
enumvalueDescriptionFormatting.TEXTPlain text.[removed: This is the default][added: Default].
Job Update API
#Documentation(55)
Documentation
- Changed the description of field
EmployerJob.roleData[removed: All data that applies to the][added: Role-level] job[removed: role][added: data].[removed: ] - Changed the description of field
EmployerJob.seatsConnectionPaginated job seats. [added: Use ]`first`[removed: : Page ][added: for page ]size[removed: . ][added: and ]`after`[removed: : Pagination ][added: for the ]cursor. - Changed the description of type
EmployerJobBasePayStandard pay[removed: is represented with][added: uses] this class[removed: , ][added: and is ]expressed as an amount[removed: paid ]per time unit. - Changed the description of field
EmployerJobBasePay.payRangeMinorPay amount in minor currency units[added: .] - Changed the description of field
EmployerJobBasePay.payTimeUnit[added: pay range to ]Time unit[removed: corresponding ][added: for the pay range.] - Changed the description of type
EmployerJobCanonicalPayCanonical pay[removed: represents multiple forms of financial][added: defines employer] compensation[removed: offered by the employer][added: across pay types].[removed: ] - Changed the description of field
EmployerJobCanonicalPay.basePayStandard base pay[removed: expressed as an amount paid for a][added: per] selected[removed: unit of ]time [added: unit ]([removed: e.g. ][added: for example, ]hourly)[added: .] - Changed the description of field
EmployerJobCanonicalPay.currency[ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)[removed: -formatted]currency code. - Changed the description of type
EmployerJobRoleData[removed: Contains all role-level][added: Role-level] data for an[removed: EmployerJob][added: `EmployerJob`]. Role[removed: data can be thought of as a set of default ]values[removed: for every seat on the job][added: are defaults for all seats]. When[removed: a field exists at ]both[removed: the role][added: `role`] and[removed: seat level, the seat data will override the role default when present][added: `seat` define a field, `seat` values take precedence]. - Changed the description of field
EmployerJobRoleData.company[removed: Name of the hiring][added: Hiring] company[removed: for the job][added: name]. - Changed the description of field
EmployerJobRoleData.metaData[removed: Various ][added: Employer job ]IDs and[removed: other meta data specific to the EmployerJob][added: metadata].[removed: ] - Changed the description of type
EmployerJobRoleMetaDataContains[removed: various meta data][added: metadata] for an[removed: [EmployerJob]][added: [`EmployerJob`]](/api/job/objects/EmployerJob). - Changed the description of field
EmployerJobRoleMetaData.dateCreatedCreation timestamp for the[removed: EmployerJob][added: `EmployerJob`]. - Changed the description of field
EmployerJobRoleMetaData.isExternalIntegratedJob[removed: Set to true when][added: `true` if] the job data[removed: originated via][added: comes from] an external ATS[removed: system ]integrated with Indeed.[removed: False][added: `false`] if[removed: the job came][added: it comes] from external crawling.[removed: Null][added: `null`] if[removed: the job was][added: it is posted] directly[removed: posted ]on Indeed. - Changed the description of type
EmployerJobSeatSeat for an[removed: [EmployerJob]][added: [`EmployerJob`]](/api/job/objects/EmployerJob). - Changed the description of field
EmployerJobSeat.jobPostThis[removed: seats][added: seat’s] job posting.[removed: ] - Changed the description of type
EmployerJobSeatData[removed: Contains all job][added: Job] data[removed: available ]for an[removed: [EmployerJobSeat]][added: [`EmployerJobSeat`]](/api/job/objects/EmployerJobSeat). If a field is[removed: not explicitly defined][added: missing] on[removed: the seat][added: `seat`] but[removed: the field does exist within the role data][added: exists in `role`],[removed: then the role value for][added: this object uses] the[removed: field will be populated here][added: `role` value]. - Changed the description of field
EmployerJobSeatData.campaignCategoriesIDs[removed: for grouping][added: that group] related seats in sponsored job campaigns. - Changed the description of field
EmployerJobSeatData.descriptionSeat description[removed: formatted ]in SRF (Selenium Rich Format). - Changed the description of field
EmployerJobSeatData.location[removed: Holds all data related to where the work][added: Work location] for[removed: a job][added: this] seat[removed: will be performed]. - Changed the description of field
EmployerJobSeatData.metaData[removed: Various][added: Seat] IDs and[removed: meta data specific to a seat][added: metadata.] - Changed the description of field
EmployerJobSeatData.pay[removed: Holds all][added: Pay] data[removed: related to pay ]for[removed: the work to be performed][added: this seat.] - Changed the description of field
EmployerJobSeatData.visibilityData[removed: Defines ][added: Visibility settings for ]when, where, and how[removed: the ]job[removed: seat is visible to job seekers][added: seekers see this seat.] - Changed the description of type
EmployerJobSeatMetaData[removed: Contains various meta data][added: Metadata] for an[removed: [EmployerJobSeat]][added: [`EmployerJobSeat`]](/api/job/objects/EmployerJobSeat). - Changed the description of field
EmployerJobSeatMetaData.jobKeyEncrypted unique[removed: identifier][added: ID] of[removed: `jobPostId` corresponding to the seats [JobPost]][added: the seat’s `jobPostId` for [`JobPost`]]([removed: /api/job/objects/EmployerJobSeat][added: /api/job/objects/JobPost]). - Changed the description of field
EmployerJobSeatMetaData.seatPostingId[removed: Posting ID for the job][added: Job] seat[removed: . Also known as ][added: posting ID, also called ]`referenceNumber` or `refnum`. - Changed the description of field
EmployerJobSeatMetaData.seatRequisitionId[removed: Requisition ID for the job seat][added: Job seat requisition ID].[removed: Takes][added: Uses] the first non-null value[removed: found ]from external job ID, `referenceNumber`, [added: or ]`referenceId`. - Changed the description of type
EmployerJobSeatVisibilityData[removed: Contains data describing][added: Describes] when, where, and how[removed: a job seat][added: an [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat)] is visible to job seekers[removed: [EmployerJobSeat](/api/job/objects/EmployerJobSeat)]. - Changed the description of field
EmployerJobSeatVisibilityData.externalJobPageUrlJob posting URL on a non-Indeed site, such as the[removed: employers][added: employer] website. - Changed the description of field
EmployerJobSeatVisibilityData.trackingUrlTracking URL for[removed: the][added: this] job seat. - Changed the description of type
EmployerJobSeatsConnectionA page of [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) results[removed: on type EmployerJobSeatsConnection][added: .] - Changed the description of field
EmployerJobSeatsConnection.edges[added: Edges in this ][`EmployerJobSeat`](/api/job/objects/EmployerJobSeat)[removed: edges for this ]connection. - Changed the description of field
EmployerJobSeatsConnection.pageInfo[removed: This connections pagination data][added: Pagination data for this connection]. - Changed the description of field
EmployerJobSeatsConnection.seats[`EmployerJobSeat`](/api/job/objects/EmployerJobSeat)[removed: results for][added: items in] this connection. - Changed the description of type
EmployerJobSeatsEdge[removed: Associates][added: Links] an [`EmployerJobSeat`](/api/job/objects/EmployerJobSeat)[removed: with][added: to] a pagination cursor. - Changed the description of field
EmployerJobSeatsEdge.cursor[removed: This edges pagination cursor][added: Pagination cursor for this edge]. - Changed the description of field
EmployerJobSeatsEdge.node[removed: The ][`EmployerJobSeat`](/api/job/objects/EmployerJobSeat) for this edge. - Changed the description of type
JobPost[removed: Indeeds][added: Indeed] job[removed: object ]view[removed: . Connects ][added: that links ]employer job data[removed: with][added: to] post-level data[removed: visible][added: shown] to job seekers. - Changed the description of field
JobPost.externalPartnerCallToAction[removed: Call][added: Input] to [added: request a call to ]action for[removed: the][added: this] job posting.[removed: ] - Changed the description of field
JobPost.id[added: Job key ][IRI]([removed: /getstarted/iris][added: /integration-basics/graphql-at-indeed/iris])[removed: of the job key].[removed: ] - Changed the description of type
JobPostCallToAction[removed: Call to action][added: Call-to-action data] for[removed: the][added: a] job[removed: posting][added: post]. - Changed the description of field
JobPostCallToAction.imageUrl[removed: Call to action][added: Call-to-action] image URL. - Changed the description of field
JobPostCallToAction.statusName[removed: Call to action][added: Call-to-action] status. - Changed the description of type
JobPostCallToActionInputInput for[removed: a ]job posting[removed: call to action][added: call-to-action data]. - Changed the description of
inputfieldJobPostCallToActionInput.localeLocale for[removed: the call to action][added: call-to-action content]. See [Supported language codes, country codes, and locales](/api/reference/language-and-country-codes). Unsupported locales default to[removed: `en-us`][added: `en-US`].[removed: ] - Changed the description of type
JobPostCallToActionStatus[removed: Status of the call to action][added: Call-to-action status] for a job[removed: posting][added: post]. - Changed the description of
enumvalueJobPostCallToActionStatus.EXPIRED[removed: The job][added: Job] posting[removed: has][added: is] expired and[removed: is ]no longer searchable on Indeed.[removed: ] - Changed the description of
enumvalueJobPostCallToActionStatus.NEEDS_SPONSORSHIP[removed: The job][added: Job] posting requires sponsorship to be searchable on Indeed.[removed: ] - Changed the description of
enumvalueJobPostCallToActionStatus.NOT_SEARCHABLE[removed: The job][added: Job] posting is not searchable on Indeed for an unspecified reason.[removed: ] - Changed the description of
enumvalueJobPostCallToActionStatus.SEARCHABLE[removed: The job][added: Job] posting is active and searchable on Indeed.[removed: ] - Changed the description of type
JobPostStatusExternal [added: job-post ]status types[removed: from the job posting].[removed: ] - Changed the description of
inputfieldJobPostStatusCommunicationSettingsInput.communicationInterfaceNameInterface name for status messages[removed: , such as][added: (for example,] `myJobBoardName`[added: )]. Combines locale and message control name.[removed: ] - Changed the description of type
JobPostStatusInputInput for[removed: `JobPost` status][added: `JobPost].[added: status`.] Required for GraphQL Federation.[removed: ] - Changed the description of
inputfieldJobPostStatusInput.surfaceContextsSurface contexts[removed: for job posting][added: used to evaluate] status.[removed: ] - Changed the description of
inputfieldJobPostSurfaceContextInput.statusCommunicationSettings[removed: Translation language][added: Language] and[removed: message type][added: message-type settings].[removed: ]
Common
#Breaking change(5)
Breaking change
- Removed directive
assetMetadata - Removed directive
retention - Removed directive
sensitiveData - Removed directive
authenticated - Removed directive
requiresScopes
Documentation(2)
Documentation
- Changed the description of field
Query.nodeReturns a reference to an entity that implements the[removed: Node][added: `Node`] interface by extracting its type (__typename) from the supplied[removed: id][added: [ID](/api/common/objects/ID)], which[removed: should be][added: is] an[removed: IRI. ][added: [IRI]]([removed: https://docs.indeed.com/api/common/objects/ID][added: /getstarted/iris])[removed: ][added: .] - Changed the description of field
Query.nodes[removed: Returns a list of][added: Lists] references to entities that[removed: implements][added: implement] the[removed: Node][added: `Node`] interface by extracting their type (__typename) from the supplied[removed: ids][added: [IDs](/api/common/objects/ID)], which[removed: should be IRIs. ][added: are [IRIs]]([removed: https://docs.indeed.com/api/common/objects/ID][added: /getstarted/iris])[removed: ][added: .]