2026-06-29

 

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

Job Sync API

Documentation

(85)

• Changed the description of type AddSeatBodyInput
  Seat body for [removed: an add operation][added: adding a seat].
• Changed the description of input field AddSeatBodyInput.location
  [removed: Complete location information][added: Location for the seat].
• Changed the description of input field AddSeatBodyInput.salary
  Salary [removed: specific to this][added: for the] seat.
• Changed the description of type AddSeatInput
  [removed: Individual][added: One] seat add operation.
• Changed the description of input field AddSeatInput.employerJob
  [removed: Identifies the employer][added: Employer] job [removed: to add][added: for] the seat[removed: to].
• Changed the description of input field AddSeatInput.seatPostingId
  Agency-provided identifier for [removed: this][added: the] seat. Must be unique across all seats on [removed: this][added: the] job. [removed: Used to reference the seat][added: Use it] in [removed: future][added: later] `updateSeats` and `clearSeats` [removed: calls][added: requests].
• Changed the description of type AddSeatMetadataInput
  Seat metadata for [removed: an add operation][added: adding a seat].
• Changed the description of input field AddSeatMetadataInput.taxonomyClassification
  Taxonomy classification for [removed: this][added: the] seat.
• Changed the description of input field AddSeatMetadataInput.trackingUrl
  Tracking URL for [removed: this][added: the] seat.
• Changed the description of input field AddSeatMetadataInput.url
  [removed: Seat-specific job][added: Job] URL[added: for the seat].
• Changed the description of type AddSeatResult
  Result for [removed: a single][added: one] seat add operation.
• Changed the description of field AddSeatResult.jobKey
  Encrypted [removed: aggJobId][added: `aggJobId`] for the seat. Pass [added: it ]to [removed: `updateSeats` / `clearSeats` via `SeatIdentifierInput.jobKey`][added: `SeatIdentifierInput.jobKey` in `updateSeats` or `clearSeats`]. [removed: Null when][added: `null` if] the seat [removed: addition][added: add] failed.
• Changed the description of type AddSeatsInput
  [removed: Input for the ]`addSeats` [removed: mutation][added: input].
• Changed the description of input field AddSeatsInput.seatAdditions
  Seat additions to process. Accepts [removed: exactly ]one item[removed: at this time].
• Changed the description of type AddSeatsPayload
  [removed: Return type for `addSeats`][added: `addSeats` return type].
• Changed the description of field AddSeatsPayload.results
  Results for each seat add[removed: operation].
• Changed the description of type ClearSeatInput
  [removed: Individual][added: One] seat clear operation.
• Changed the description of input field ClearSeatInput.employerJob
  [removed: Identifies the employer][added: Employer] job [removed: whose seat is being removed][added: for the seat].
• Changed the description of input field ClearSeatInput.seatIdentifier
  [removed: Identifies the seat][added: Seat] to remove. Provide [removed: exactly ]one field.
• Changed the description of type ClearSeatResult
  Result for [removed: a single][added: one] seat clear operation.
• Changed the description of field ClearSeatResult.jobKey
  Encrypted [removed: aggJobId][added: `aggJobId`] for the seat.
• Changed the description of type ClearSeatsInput
  [removed: Input for the ]`clearSeats` [removed: mutation][added: input].
• Changed the description of input field ClearSeatsInput.seatRemovals
  Seat removals to process. Accepts [removed: exactly ]one item[removed: at this time].
• Changed the description of type ClearSeatsPayload
  [removed: Return type for `clearSeats`][added: `clearSeats` return type].
• Changed the description of field ClearSeatsPayload.results
  Results for each seat clear[removed: operation].
• Changed the description of type ClearSourcedJobPostingUpdateInput
  Clears [removed: all ]updates from [removed: the ]`updateSourcedJobPostings`[removed: mutation]. [removed: **Note**: ]Not atomic. Errors can [removed: cause partial clears][added: partially clear updates].
• Changed the description of input field ClearSourcedJobPostingUpdateInput.sourcedPostingId
  Job post UUID from `createSourcedJobPostings`, or [removed: an ]employer job ID [removed: (][added: as a ]UUID or base64-encoded [`EmployerJob`](/api/job/objects/EmployerJob) [IRI](/getstarted/iris)[removed: )].
• Changed the description of field ClearSourcedJobPostingUpdateResult.jobPosting
  [removed: Job posting that was cleared.][added: The cleared job posting, or] null if [removed: no updates were][added: nothing was] cleared.
• Changed the description of type ClearSourcedJobPostingUpdatesInput
  [removed: Input for the ]`clearSourcedJobPostingUpdates` [removed: mutation][added: input].
• Changed the description of type ClearSourcedJobPostingUpdatesPayload
  Return type for [removed: `updateSourcedJobPostings`][added: `clearSourcedJobPostingUpdates`].
• Changed the description of field ClearSourcedJobPostingUpdatesPayload.results
  Results for each clear operation. Array [removed: values][added: items] are [removed: non-null][added: never null], but `jobPosting` can be null if [removed: updates were not][added: nothing was] cleared.
• Changed the description of type DescriptionFormatting
  [removed: Format of the job][added: Job] description [removed: content][added: format].
• Changed the description of enum value DescriptionFormatting.HTML
  HTML[removed: format].
• Changed the description of enum value DescriptionFormatting.TEXT
  Plain text[removed: format]. [removed: Default if not specified][added: This is the default].
• Changed the description of type EmployerJobIdentifierInput
  Identifies the employer job[removed: by][added: . Provide] exactly one [removed: of][added: field]: `sourcedPostingId` [removed: (][added: as a ]UUID[removed: )][added: ,] or `employerJobId` [removed: (][added: as a ]base64-encoded IRI[removed: )].
• Changed the description of input field EmployerJobIdentifierInput.employerJobId
  Base64-encoded IRI from `EmployerJob`. Accepts values [removed: returned by][added: from] `createSourcedJobPostings` or [removed: the ]`EmployerJob`[removed: type].
• Changed the description of field JobsIngestMutations.addSeats
  Adds [removed: new ]seats to [removed: an existing][added: a] job. Fails if [removed: seatPostingId ][added: the `seatPostingId` ]already exists.
• Changed the description of field JobsIngestMutations.clearSeats
  [removed: Clears/expires ][added: Clears or expires ]seats from [removed: an existing][added: a] job.
• Changed the description of field JobsIngestMutations.clearSourcedJobPostingUpdates
  Clears updates [removed: from the][added: made by] `updateSourcedJobPostings`[removed: mutation].
• Changed the description of field JobsIngestMutations.updateSeats
  Updates [removed: existing ]seats on a job.
• Changed the description of field JobsIngestMutations.updateSourcedJobPostings
  Updates a sourced job. [removed: The caller][added: You] must [removed: have claimed][added: claim] the job source[removed: . Accepts one update per call; multiple updates cause an error][added: before calling this mutation. Only one update is allowed per call].
• Changed the description of type SeatIdentifierInput
  Identifies [removed: a][added: the] seat by `jobKey`.
• Changed the description of input field SeatIdentifierInput.jobKey
  Encrypted [removed: unique identifier of ]`jobPostId` [removed: corresponding to][added: for] the seats [removed: [JobPost](https://docs.indeed.com/api/job/objects/JobPost)][added: `JobPost`]. Returned [removed: in][added: by] `addSeats`[removed: ; ][added: and ]also available on [removed: [EmployerJobSeatMetaData](https://docs.indeed.com/api/job/objects/EmployerJobSeatMetaData)][added: `EmployerJobSeatMetaData`].
• Changed the description of type SeatJobPostingSalaryInput
  Salary for a seat. Use `maximumMinor` and `minimumMinor` for a range[removed: , or ][added: . For a fixed salary, ]set both [added: fields ]to the same value[removed: for a fixed salary].
• Changed the description of input field SeatJobPostingSalaryInput.currency
  Salary currency in ISO 4217 format[removed: (][added: , ]such as `USD`[removed: )].
• Changed the description of input field SeatLocationInput.cityRegionPostal
  [added: City, region (state/province), and postal code. Examples: `Austin, TX, 78701` (USA); `Mayfair, London, W1J` (UK); `100-8994 東京都千代田区丸の内` (Japan) to City, region, and postal code. Examples: `Austin, TX, 78701`, `Mayfair, London, W1J`, `100-8994 東京都千代田区丸の内`.]
• Changed the description of input field SeatLocationInput.latitude
  [removed: Job location latitude][added: Latitude for the job location].
• Changed the description of input field SeatLocationInput.longitude
  [removed: Job location longitude][added: Longitude for the job location].
• Changed the description of input field SeatLocationInput.streetAddress
  Street address. Example: `1600 Pennsylvania Ave`[removed: (USA)].
• Changed the description of input field SeatTaxonomyInput.attributes
  Taxonomy attributes [removed: (][added: as ][SUIDs](https://docs.indeed.com/getstarted/understanding-suids/#suid-format) or strings[removed: )]. Maximum 100 per seat.
• Changed the description of input field SeatTaxonomyInput.remoteType
  Location flexibility. Omit [added: this field ]or set [added: it ]to `null` for non-remote jobs. Values: `Fully Remote`, `Hybrid Remote`.
• Changed the description of type SourcedJobPostingUpdate
  Return type for an accepted job update. Changes might not appear [removed: immediately][added: right away].
• Changed the description of field SourcedJobPostingUpdate.employerJobId
  Employer job ID[removed: (][added: , ]base64-encoded [added: as an ][IRI](/getstarted/iris)[removed: )].
• Changed the description of type UpdateSeatBodyInput
  Seat body for [removed: an update operation][added: updating a seat]. All fields [removed: optional — provide][added: are optional. Provide] only [removed: those changing][added: changed fields].
• Changed the description of type UpdateSeatInput
  [removed: Individual][added: One] seat update operation.
• Changed the description of input field UpdateSeatInput.employerJob
  [removed: Identifies the employer][added: Employer] job [removed: whose seat is being updated][added: for the seat].
• Changed the description of input field UpdateSeatInput.seatIdentifier
  [removed: Identifies the seat][added: Seat] to update. Provide [removed: exactly ]one field.
• Changed the description of type UpdateSeatMetadataInput
  Seat metadata for [removed: an update operation][added: updating a seat].
• Changed the description of input field UpdateSeatMetadataInput.taxonomyClassification
  Taxonomy classification for [removed: this][added: the] seat.
• Changed the description of input field UpdateSeatMetadataInput.trackingUrl
  Tracking URL for [removed: this][added: the] seat. Omit or set to `null` for no change.
• Changed the description of input field UpdateSeatMetadataInput.url
  [removed: Seat-specific job][added: Job] URL[added: for the seat]. Omit or set to `null` for no change.
• Changed the description of type UpdateSeatResult
  Result for [removed: a single][added: one] seat update[removed: operation].
• Changed the description of field UpdateSeatResult.seatPostingId
  Agency-provided seat [removed: identifier][added: ID].
• Changed the description of type UpdateSeatsInput
  [removed: Input for the ]`updateSeats` [removed: mutation][added: input].
• Changed the description of input field UpdateSeatsInput.seatUpdates
  Seat updates to process. Accepts [removed: exactly ]one item[removed: at this time].
• Changed the description of field UpdateSeatsPayload.results
  Results for each seat update[removed: operation].
• Changed the description of type UpdateSourcedJobPostingBodyInput
  [removed: Updates the][added: Updated] job [removed: posting ]body. See [`UpdateSourcedJobPostingInput.body`](https://docs.indeed.com/api/job/objects/UpdateSourcedJobPostingInput).
• Changed the description of input field UpdateSourcedJobPostingBodyInput.companyName
  Company name[removed: (max][added: . Maximum] 200 characters[removed: )]. Omit or set to [removed: null][added: `null`] for no change.
• Changed the description of input field UpdateSourcedJobPostingBodyInput.description
  Job description[removed: (30–20][added: . 30 to 20],000 characters[removed: )]. Omit or set to [removed: null][added: `null`] for no change.
• Changed the description of input field UpdateSourcedJobPostingBodyInput.jobLocation
  Job location. Omit or set to [removed: null][added: `null`] for no change.
• Changed the description of input field UpdateSourcedJobPostingBodyInput.salary
  Job salary. Omit or set to [removed: null][added: `null`] for no change.
• Changed the description of input field UpdateSourcedJobPostingBodyInput.title
  Job title[removed: (max][added: . Maximum] 75 characters[removed: )]. Omit or set to [removed: null][added: `null`] for no change.
• Changed the description of input field UpdateSourcedJobPostingGeneralLocationInput.cityRegionPostal
  [added: City, region (state/county/prefecture), and postal code. Examples: Washington, District of Columbia, 20500 (USA); Mayfair, London, W1J (UK) to City, region, and postal code. Examples: `Washington, District of Columbia, 20500`, `Mayfair, London, W1J`.]
• Changed the description of input field UpdateSourcedJobPostingGeneralLocationInput.streetAddress
  [added: Street address of the job location. Example: 1600 Pennsylvania Ave (USA) to Street address of the job location. Example: `1600 Pennsylvania Ave`.]
• Changed the description of input field UpdateSourcedJobPostingInput.sourcedPostingId
  Employer job UUID from `createSourcedJobPostings`. [removed: Accepts UUID or][added: Also accepts a] base64-encoded IRI from `EmployerJob`.
• Changed the description of type UpdateSourcedJobPostingLocationInput
  Job location update. Provide [removed: exactly ]one field or [added: the API returns ]an error[removed: occurs].
• Changed the description of input field UpdateSourcedJobPostingLocationInput.general
  General location input. Accepts values from [removed: `cityRegionPostal `to][added: `cityRegionPostal` to] specific addresses.
• Changed the description of type UpdateSourcedJobPostingMetadataInput
  Job metadata to update. [removed: At ][added: Provide at ]least one field[removed: required]. [removed: **Note**: ]Not atomic. Errors can cause partial updates.
• Changed the description of input field UpdateSourcedJobPostingMetadataInput.campaignCategories
  Category tags [removed: to group jobs ]for [removed: campaigns][added: campaign grouping].
• Changed the description of field UpdateSourcedJobPostingResult.jobPosting
  [removed: Job posting for the update.][added: Updated job posting, or] null if the update was not accepted.
• Changed the description of input field UpdateSourcedJobPostingSalaryInput.currency
  Salary currency in ISO 4217 format[removed: (][added: , ]such as `USD`[removed: )]. Omit or set to [removed: null][added: `null`] for no change.
• Changed the description of input field UpdateSourcedJobPostingSalaryInput.maximumMinor
  Maximum amount in local minor currency. Omit or set to [removed: null][added: `null`] to clear.
• Changed the description of input field UpdateSourcedJobPostingSalaryInput.minimumMinor
  Minimum amount in local minor currency. Omit or set to [removed: null][added: `null`] to clear.
• Changed the description of type UpdateSourcedJobPostingsInput
  [removed: Input for the ]`updateSourcedJobPostings` [removed: mutation][added: input].
• Changed the description of field UpdateSourcedJobPostingsPayload.results
  Results for each update. Array [removed: values][added: items] are [removed: non-null][added: never null], but `jobPosting` is null if the update was not accepted.

 

Was this page helpful?