2026-08-17

GraphQL schema change log: 2026-08-17

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

Changed the description of type AddSeatBodyInput from:
```
Seat body for adding a seat. 
```
To:
```
Body data for a new seat.
```
Changed the description of input field AddSeatBodyInput.location from:
```
Location for the seat.
```
To:
```
Seat location.
```
Changed the description of input field AddSeatBodyInput.salary from:
```
Salary for the seat.
```
To:
```
Seat salary.
```
Changed the description of type AddSeatInput from:
```
One seat add operation. 
```
To:
```
One seat to add.
```
Changed the description of input field AddSeatInput.body from:
```
Seat body data. 
```
To:
```
Seat body.
```

Changed the description of input field AddSeatInput.seatPostingId from:

Agency-provided identifier for the seat. Must be unique across all seats on the job. Use it in later `updateSeats` and `clearSeats` requests.

To:

Agency-provided seat ID. Must be unique across all seats on the job.

Changed the description of type AddSeatMetadataInput from:
```
Seat metadata for adding a seat.
```
To:
```
Metadata for a new seat.
```
Changed the description of input field AddSeatMetadataInput.taxonomyClassification from:
```
Taxonomy classification for the seat.
```
To:
```
Taxonomy classification.
```
Changed the description of input field AddSeatMetadataInput.trackingUrl from:
```
Tracking URL for the seat.
```
To:
```
Tracking URL.
```
Changed the description of input field AddSeatMetadataInput.url from:
```
Job URL for the seat.
```
To:
```
Job URL.
```
Changed the description of type AddSeatResult from:
```
Result for one seat add operation.
```
To:
```
Result for one seat add.
```
Changed the description of field AddSeatResult.employerJobId from:
```
Base64-encoded IRI of the employer job.
```
To:
```
Employer job ID as a base64-encoded IRI.
```

Changed the description of field AddSeatResult.jobKey from:

Encrypted `aggJobId` for the seat. Pass it to `SeatIdentifierInput.jobKey` in `updateSeats` or `clearSeats`.
`null` if the seat add failed.

To:

Encrypted `aggJobId` for the seat returned by [`addSeats`](/api/job/mutations/jobsIngest/addSeats).
Pass it to `SeatIdentifierInput.jobKey` in [`updateSeats`](/api/job/mutations/jobsIngest/updateSeats) or [`clearSeats`](/api/job/mutations/jobsIngest/clearSeats).
If the seat add failed, the value is null.

Changed the description of field AddSeatResult.seatPostingId from:
```
Agency-provided seat identifier.
```
To:
```
Agency-provided seat ID.
```
Changed the description of field AddSeatResult.sourcedPostingId from:
```
UUID form of the employer job ID.
```
To:
```
Employer job ID as a UUID.
```
Changed the description of type AddSeatsInput from:
```
`addSeats` input.
```
To:
```
Input for `addSeats`.
```
Changed the description of input field AddSeatsInput.seatAdditions from:
```
Seat additions to process. Accepts one item.
```
To:
```
Seat additions to process.
```
Changed the description of type AddSeatsPayload from:
```
`addSeats` return type.
```
To:
```
Payload for `addSeats`.
```
Changed the description of type ClearSeatInput from:
```
One seat clear operation.
```
To:
```
One seat to remove.
```
Changed the description of input field ClearSeatInput.seatIdentifier from:
```
Seat to remove. Provide one field.
```
To:
```
Seat to remove.
Provide one field.
```
Changed the description of type ClearSeatResult from:
```
Result for one seat clear operation.
```
To:
```
Result for one seat clear.
```
Changed the description of field ClearSeatResult.employerJobId from:
```
Base64-encoded IRI of the employer job.
```
To:
```
Employer job ID as a base64-encoded IRI.
```

Changed the description of field ClearSeatResult.jobKey from:

Encrypted `aggJobId` for the seat.

To:

Encrypted `aggJobId` for the seat returned by [`addSeats`](/api/job/mutations/jobsIngest/addSeats).
Pass it to `SeatIdentifierInput.jobKey` in [`updateSeats`](/api/job/mutations/jobsIngest/updateSeats) or [`clearSeats`](/api/job/mutations/jobsIngest/clearSeats).
If the seat add failed, the value is null.

Changed the description of field ClearSeatResult.seatPostingId from:
```
Agency-provided seat identifier.
```
To:
```
Agency-provided seat ID.
```
Changed the description of field ClearSeatResult.sourcedPostingId from:
```
UUID form of the employer job ID.
```
To:
```
Employer job ID as a UUID.
```
Changed the description of type ClearSeatsInput from:
```
`clearSeats` input.
```
To:
```
Input for `clearSeats`.
```
Changed the description of input field ClearSeatsInput.seatRemovals from:
```
Seat removals to process. Accepts one item.
```
To:
```
Seat removals to process.
Accepts one item.
```
Changed the description of type ClearSeatsPayload from:
```
`clearSeats` return type.
```
To:
```
Payload for `clearSeats`.
```

Changed the description of type ClearSourcedJobPostingUpdateInput from:

Clears updates from `updateSourcedJobPostings`.
Not atomic. Errors can partially clear updates.

To:

One job posting with updates from `updateSourcedJobPostings` to clear.
Not atomic. Errors can partially clear updates.

Changed the description of input field ClearSourcedJobPostingUpdateInput.sourcedPostingId from:

Job post UUID from `createSourcedJobPostings`, or employer job ID as a UUID or base64-encoded [`EmployerJob`](/api/job/objects/EmployerJob) [IRI](/getstarted/iris).

To:

Job post UUID from `createSourcedJobPostings`.
Also accepts an employer job ID as a UUID or a base64-encoded [`EmployerJob`](/api/job/objects/EmployerJob) [IRI](/integration-basics/graphql-at-indeed/iris).

Changed the description of type ClearSourcedJobPostingUpdateResult from:
```
Return type for each `clearJobPostingUpdates` result.
```
To:
```
Result for one `clearSourcedJobPostingUpdates` operation.
```
Changed the description of field ClearSourcedJobPostingUpdateResult.jobPosting from:
```
The cleared job posting, or null if nothing was cleared.
```
To:
```
Cleared job posting. If nothing was cleared, null.
```
Changed the description of type ClearSourcedJobPostingUpdatesInput from:
```
`clearSourcedJobPostingUpdates` input.
```
To:
```
Input for `clearSourcedJobPostingUpdates`.
```
Changed the description of type ClearSourcedJobPostingUpdatesPayload from:
```
Return type for `clearSourcedJobPostingUpdates`.
```
To:
```
Payload for `clearSourcedJobPostingUpdates`.
```

Changed the description of field ClearSourcedJobPostingUpdatesPayload.results from:

Results for each clear operation.
Array items are never null, but `jobPosting` can be null if nothing was cleared.

To:

Results for each clear. Array items are never null.
If nothing was cleared, `jobPosting` can be null.

Changed the description of type DateTime from:
```
Date with time (isoformat)
```
To:
```
Datetime as [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339).
```

Changed the description of type EmployerJobIdentifierInput from:

Identifies the employer job. Provide exactly one field: `sourcedPostingId` as a UUID, or `employerJobId` as a base64-encoded IRI.

To:

Identifies the employer job.
Provide exactly one field: `sourcedPostingId` as a UUID, or `employerJobId` as a base64-encoded IRI.

Changed the description of input field EmployerJobIdentifierInput.employerJobId from:

Base64-encoded IRI from `EmployerJob`. Accepts values from `createSourcedJobPostings` or `EmployerJob`.

To:

Base64-encoded IRI from `EmployerJob`.
Accepts values from `createSourcedJobPostings` or `EmployerJob`.

Object type JobsIngestMutations has description:
```
Job ingest mutations.
```
Changed the description of argument input on field JobsIngestMutations.addSeats from:
```
null
```
To:
```
Seat-add input.
```
Changed the description of field JobsIngestMutations.clearSeats from:
```
Clears or expires seats from a job.
```
To:
```
Clears or expires seats on a job.
```
Changed the description of argument input on field JobsIngestMutations.clearSeats from:
```
null
```
To:
```
Seat-clear input.
```
Changed the description of argument input on field JobsIngestMutations.clearSourcedJobPostingUpdates from:
```
null
```
To:
```
Clear-updates input.
```
Changed the description of argument input on field JobsIngestMutations.updateSeats from:
```
null
```
To:
```
Seat-update input.
```

Changed the description of field JobsIngestMutations.updateSourcedJobPostings from:

Updates a sourced job. You must claim the job source before calling this mutation. Only one update is allowed per call.

To:

Updates a sourced job.
Claim the job source before calling this mutation.
One update per call.

Changed the description of argument input on field JobsIngestMutations.updateSourcedJobPostings from:
```
null
```
To:
```
Job posting update input.
```

Changed the description of input field SeatIdentifierInput.jobKey from:

Encrypted `jobPostId` for the seats `JobPost`. Returned by `addSeats` and also available on `EmployerJobSeatMetaData`.

To:

Encrypted `aggJobId` for the seat returned by [`addSeats`](/api/job/mutations/jobsIngest/addSeats).
Pass it to `SeatIdentifierInput.jobKey` in [`updateSeats`](/api/job/mutations/jobsIngest/updateSeats) or [`clearSeats`](/api/job/mutations/jobsIngest/clearSeats).
If the seat add failed, the value is null.

Changed the description of type SeatJobPostingSalaryInput from:

Salary for a seat. Use `maximumMinor` and `minimumMinor` for a range. For a fixed salary, set both fields to the same value.

To:

Salary for a seat.
Use `maximumMinor` and `minimumMinor` for a range.
For a fixed salary, set both to the same value.

Changed the description of input field SeatLocationInput.country from:

Country code. See [Supported language codes, country codes, and locales](https://docs.indeed.com/api/job/objects/CreateSourcedJobPostingInput#language-codes-and-locales).

To:

Country code.
See [Supported language codes, country codes, and locales](https://docs.indeed.com/api/job/objects/CreateSourcedJobPostingInput#language-codes-and-locales).

Changed the description of input field SeatLocationInput.latitude from:
```
Latitude for the job location.
```
To:
```
Latitude.
```
Changed the description of input field SeatLocationInput.longitude from:
```
Longitude for the job location.
```
To:
```
Longitude.
```
Changed the description of input field SeatLocationInput.streetAddress from:
```
Street address. Example: `1600 Pennsylvania Ave`.
```
To:
```
Street address.
Example: `1600 Pennsylvania Ave`.
```

Changed the description of input field SeatTaxonomyInput.attributes from:

Taxonomy attributes as [SUIDs](https://docs.indeed.com/getstarted/understanding-suids/#suid-format) or strings. Maximum 100 per seat.

To:

Taxonomy attributes as [SUIDs](https://docs.indeed.com/getstarted/understanding-suids/#suid-format) or strings.
Maximum 100 per seat.

Changed the description of input field SeatTaxonomyInput.remoteType from:

Location flexibility. Omit this field or set it to `null` for non-remote jobs.
Values: `Fully Remote`, `Hybrid Remote`.

To:

Location flexibility.
Omit or set to null for non-remote jobs.
Values: `Fully Remote`, `Hybrid Remote`.

Changed the description of type SourcedJobPostingUpdate from:

Return type for an accepted job update. Changes might not appear right away.

To:

Accepted job update.
Changes might not appear right away.

Changed the description of field SourcedJobPostingUpdate.employerJobId from:

Employer job ID, base64-encoded as an [IRI](/getstarted/iris).

To:

Employer job ID as a base64-encoded [IRI](/integration-basics/graphql-at-indeed/iris).

Changed the description of type UpdateSeatBodyInput from:

Seat body for updating a seat. All fields are optional. Provide only changed fields.

To:

Body data for a seat update.
All fields are optional.
Provide only changed fields.  

Changed the description of input field UpdateSeatBodyInput.location from:

Updated location. Omit or set to `null` for no change.

To:

Updated location. To leave the value unchanged, omit this field or set it to null.

Changed the description of input field UpdateSeatBodyInput.salary from:

Updated salary. Omit or set to `null` for no change.

To:

Updated salary. To leave the value unchanged, omit this field or set it to null.

Changed the description of type UpdateSeatInput from:
```
One seat update operation.
```
To:
```
One seat to update.  
```
Changed the description of input field UpdateSeatInput.body from:
```
Seat body data. Omit fields for no change.
```
To:
```
Seat body. To leave the value unchanged, omit this field or set it to null.
```
Changed the description of input field UpdateSeatInput.metadata from:
```
Seat metadata. Omit fields for no change.
```
To:
```
Seat metadata. To leave the value unchanged, omit this field or set it to null.
```
Changed the description of type UpdateSeatMetadataInput from:
```
Seat metadata for updating a seat.  
```
To:
```
Metadata for a seat update.  
```
Changed the description of input field UpdateSeatMetadataInput.taxonomyClassification from:
```
Taxonomy classification for the seat.
```
To:
```
Taxonomy classification.
```

Changed the description of input field UpdateSeatMetadataInput.trackingUrl from:

Tracking URL for the seat. Omit or set to `null` for no change.

To:

Tracking URL.
To leave the value unchanged, omit this field or set it to null.

Changed the description of input field UpdateSeatMetadataInput.url from:

Job URL for the seat. Omit or set to `null` for no change.

To:

Job URL.
To leave the value unchanged, omit this field or set it to null.

Changed the description of field UpdateSeatResult.employerJobId from:
```
Base64-encoded IRI of the employer job.
```
To:
```
Employer job ID as a base64-encoded IRI.
```

Changed the description of field UpdateSeatResult.jobKey from:

Encrypted `aggJobId` for the seat.

To:

Encrypted `aggJobId` for the seat returned by [`addSeats`](/api/job/mutations/jobsIngest/addSeats).
Pass it to `SeatIdentifierInput.jobKey` in [`updateSeats`](/api/job/mutations/jobsIngest/updateSeats) or [`clearSeats`](/api/job/mutations/jobsIngest/clearSeats).
If the seat add failed, the value is null.

Changed the description of field UpdateSeatResult.sourcedPostingId from:
```
UUID form of the employer job ID.
```
To:
```
Employer job ID as a UUID.
```
Changed the description of type UpdateSeatsInput from:
```
`updateSeats` input.
```
To:
```
Input for `updateSeats`.
```
Changed the description of type UpdateSeatsPayload from:
```
Return type for `updateSeats`.
```
To:
```
Payload for `updateSeats`.
```

Changed the description of type UpdateSourcedJobPostingBodyInput from:

Updated job body. See [`UpdateSourcedJobPostingInput.body`](https://docs.indeed.com/api/job/objects/UpdateSourcedJobPostingInput).

To:

Updated job body.
See [`UpdateSourcedJobPostingInput.body`](https://docs.indeed.com/api/job/objects/UpdateSourcedJobPostingInput).

Changed the description of input field UpdateSourcedJobPostingBodyInput.companyName from:

Company name. Maximum 200 characters. Omit or set to `null` for no change.

To:

Company name. Maximum 200 characters. To leave the value unchanged, omit this field or set it to null.

Changed the description of input field UpdateSourcedJobPostingBodyInput.description from:

Job description. 30 to 20,000 characters. Omit or set to `null` for no change.

To:

Job description shown to job seekers.
* Plain text (`TEXT`): 30 to 20,000 characters.
* HTML (`HTML`): at least 30 characters, at most 65,000 [UTF-8](https://www.rfc-editor.org/info/rfc3629/) bytes. Multibyte characters count toward the byte limit.
To leave the value unchanged, omit this field or set it to null.
Must match the job at [`SourcedJobPostingMetadataInput.url`](/api/job/objects/SourcedJobPostingMetadataInput).
If the client uses HTML on job list or details pages, Indeed requires HTML for XML and API jobs unless there is a good reason not to. To send HTML, set `descriptionFormatting` to `RICH_FORMATTING`. See [Job description formatting](/job-sync-api/reference/job-description-formatting).

Changed the description of input field UpdateSourcedJobPostingBodyInput.descriptionFormatting from:

Description format. Omit to use the default `TEXT`.

To:

Job description format. To send HTML, set this field to `RICH_FORMATTING`.
See [Job description formatting](/job-sync-api/reference/job-description-formatting).

Changed the description of input field UpdateSourcedJobPostingBodyInput.jobLocation from:
```
Job location. Omit or set to `null` for no change.
```
To:
```
Job location. To leave the value unchanged, omit this field or set it to null.
```

Changed the description of input field UpdateSourcedJobPostingBodyInput.salary from:

Job salary. Omit or set to `null` for no change.

To:

Job salary. To leave the value unchanged, omit this field or set it to null.
Every non-null `salary` object must include `period`, including when `maximumMinor` or `minimumMinor` is set to null to clear a value.

Changed the description of input field UpdateSourcedJobPostingBodyInput.title from:

Job title. Maximum 75 characters. Omit or set to `null` for no change.

To:

Job title. Maximum 75 characters. To leave the value unchanged, omit this field or set it to null.

Object type UpdateSourcedJobPostingGeneralLocationInput has description:
```
City, region, postal code, and optional street address.
```
Changed the description of input field UpdateSourcedJobPostingGeneralLocationInput.streetAddress from:
```
Street address of the job location.
Example: `1600 Pennsylvania Ave`.
```
To:
```
Street address.
Example: `1600 Pennsylvania Ave`.
```
Changed the description of type UpdateSourcedJobPostingInput from:
```
Job posting update input.
```
To:
```
One job posting update.  
```

Changed the description of input field UpdateSourcedJobPostingInput.sourcedPostingId from:

Employer job UUID from `createSourcedJobPostings`. Also accepts a base64-encoded IRI from `EmployerJob`.

To:

Employer job UUID from `createSourcedJobPostings`. 
Also accepts a base64-encoded [IRI](/integration-basics/graphql-at-indeed/iris) from `EmployerJob`.

Changed the description of type UpdateSourcedJobPostingLocationInput from:

Job location update. Provide one field or the API returns an error.

To:

Job location update.  
Provide one field or the API returns an error.

Changed the description of input field UpdateSourcedJobPostingLocationInput.general from:

General location input. Accepts values from `cityRegionPostal` to specific addresses.

To:

General location, from `cityRegionPostal` to a specific address.

Changed the description of type UpdateSourcedJobPostingMetadataInput from:

Job metadata to update. Provide at least one field.
Not atomic. Errors can cause partial updates.

To:

Job metadata to update. Not atomic. Errors can cause partial updates.

Changed the description of input field UpdateSourcedJobPostingMetadataInput.trackingUrl from:
```
Job tracking URL.
```
To:
```
Tracking URL.
```
Changed the description of type UpdateSourcedJobPostingResult from:
```
Return type for each `updateSourcedJobPostings` result.
```
To:
```
Result for one `updateSourcedJobPostings` operation.  
```
Changed the description of field UpdateSourcedJobPostingResult.jobPosting from:
```
Updated job posting, or null if the update was not accepted.
```
To:
```
Updated job posting. Null if the update was not accepted.
```
Object type UpdateSourcedJobPostingSalaryInput has description:
```
Salary update.
```

Changed the description of input field UpdateSourcedJobPostingSalaryInput.currency from:

Salary currency in ISO 4217 format, such as `USD`. Omit or set to `null` for no change.

To:

Salary currency in ISO 4217 format, such as `USD`.
To leave the value unchanged, omit this field or set it to null.

Changed the description of input field UpdateSourcedJobPostingSalaryInput.maximumMinor from:

Maximum amount in local minor currency. Omit or set to `null` to clear.

To:

Maximum amount in local minor currency.
To clear, omit this field or set it to null.
Every non-null `salary` object must include `period`, including when `maximumMinor` is set to null to clear a value.

Changed the description of input field UpdateSourcedJobPostingSalaryInput.minimumMinor from:

Minimum amount in local minor currency. Omit or set to `null` to clear.

To:

Minimum amount in local minor currency.
To clear, omit this field or set it to null.
Every non-null `salary` object must include `period`, including when `minimumMinor` is set to null to clear a value.

Changed the description of input field UpdateSourcedJobPostingSalaryInput.period from:

Salary period.

To:

Salary period.
Every non-null `salary` object must include `period`, including when `maximumMinor` or `minimumMinor` is set to null to clear a value.

Changed the description of type UpdateSourcedJobPostingsInput from:
```
`updateSourcedJobPostings` input.
```
To:
```
Input for `updateSourcedJobPostings`.
```
Changed the description of type UpdateSourcedJobPostingsPayload from:
```
Return type for `updateSourcedJobPostings`.
```
To:
```
Payload for `updateSourcedJobPostings`.
```

Changed the description of field UpdateSourcedJobPostingsPayload.results from:

Results for each update. Array items are never null, but `jobPosting` is null if the update was not accepted.

To:

Results for each update. Array items are never null.
`jobPosting` is null if the update was not accepted.

Changed the description of type WebUrl from:

Well-formed URL. Specification: [RFC 2396/2732](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier)

To:

A well-formed URL ([RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)).

GraphQL schema change log: 2026-08-17​

Was this page helpful?

GraphQL schema change log: 2026-08-17