2026-06-29

GraphQL schema change log: 2026-06-29

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

Changed the description of type AddSeatBodyInput from:
```
Seat body for an add operation.
```
To:
```
Seat body for adding a seat.
```
Changed the description of input field AddSeatBodyInput.location from:
```
Complete location information.
```
To:
```
Location for the seat.
```
Changed the description of input field AddSeatBodyInput.salary from:
```
Salary specific to this seat.
```
To:
```
Salary for the seat.
```
Changed the description of type AddSeatInput from:
```
Individual seat add operation.
```
To:
```
One seat add operation.
```
Changed the description of input field AddSeatInput.employerJob from:
```
Identifies the employer job to add the seat to.
```
To:
```
Employer job for the seat.
```

Changed the description of input field AddSeatInput.seatPostingId from:

Agency-provided identifier for this seat. Must be unique across all seats on this job. Used to reference the seat in future `updateSeats` and `clearSeats` calls.

To:

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

Changed the description of type AddSeatMetadataInput from:
```
Seat metadata for an add operation.
```
To:
```
Seat metadata for adding a seat.
```
Changed the description of input field AddSeatMetadataInput.taxonomyClassification from:
```
Taxonomy classification for this seat.
```
To:
```
Taxonomy classification for the seat.
```
Changed the description of input field AddSeatMetadataInput.trackingUrl from:
```
Tracking URL for this seat.
```
To:
```
Tracking URL for the seat.
```
Changed the description of input field AddSeatMetadataInput.url from:
```
Seat-specific job URL.
```
To:
```
Job URL for the seat.
```
Changed the description of type AddSeatResult from:
```
Result for a single seat add operation.
```
To:
```
Result for one seat add operation.
```

Changed the description of field AddSeatResult.jobKey from:

Encrypted aggJobId for the seat. Pass to `updateSeats` / `clearSeats` via `SeatIdentifierInput.jobKey`.

Null when the seat addition failed.

To:

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

`null` if the seat add failed.

Changed the description of type AddSeatsInput from:
```
Input for the `addSeats` mutation.
```
To:
```
`addSeats` input.
```
Changed the description of input field AddSeatsInput.seatAdditions from:
```
Seat additions to process. Accepts exactly one item at this time.
```
To:
```
Seat additions to process. Accepts one item.
```
Changed the description of type AddSeatsPayload from:
```
Return type for `addSeats`.
```
To:
```
`addSeats` return type.
```
Changed the description of field AddSeatsPayload.results from:
```
Results for each seat add operation.
```
To:
```
Results for each seat add.
```
Changed the description of type ClearSeatInput from:
```
Individual seat clear operation.
```
To:
```
One seat clear operation.
```
Changed the description of input field ClearSeatInput.employerJob from:
```
Identifies the employer job whose seat is being removed.
```
To:
```
Employer job for the seat.
```
Changed the description of input field ClearSeatInput.seatIdentifier from:
```
Identifies the seat to remove. Provide exactly one field.
```
To:
```
Seat to remove. Provide one field.
```
Changed the description of type ClearSeatResult from:
```
Result for a single seat clear operation.
```
To:
```
Result for one seat clear operation.
```
Changed the description of field ClearSeatResult.jobKey from:
```
Encrypted aggJobId for the seat.
```
To:
```
Encrypted `aggJobId` for the seat.
```
Changed the description of type ClearSeatsInput from:
```
Input for the `clearSeats` mutation.
```
To:
```
`clearSeats` input.
```
Changed the description of input field ClearSeatsInput.seatRemovals from:
```
Seat removals to process. Accepts exactly one item at this time.
```
To:
```
Seat removals to process. Accepts one item.
```
Changed the description of type ClearSeatsPayload from:
```
Return type for `clearSeats`.
```
To:
```
`clearSeats` return type.
```
Changed the description of field ClearSeatsPayload.results from:
```
Results for each seat clear operation.
```
To:
```
Results for each seat clear.
```

Changed the description of type ClearSourcedJobPostingUpdateInput from:

Clears all updates from the `updateSourcedJobPostings` mutation.

**Note**: Not atomic. Errors can cause partial clears.

To:

Clears updates from `updateSourcedJobPostings`.

Not atomic. Errors can partially clear updates.

Changed the description of input field ClearSourcedJobPostingUpdateInput.sourcedPostingId from:

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

To:

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

Changed the description of field ClearSourcedJobPostingUpdateResult.jobPosting from:
```
Job posting that was cleared. null if no updates were cleared.
```
To:
```
The cleared job posting, or null if nothing was cleared.
```
Changed the description of type ClearSourcedJobPostingUpdatesInput from:
```
Input for the `clearSourcedJobPostingUpdates` mutation.
```
To:
```
`clearSourcedJobPostingUpdates` input.
```
Changed the description of type ClearSourcedJobPostingUpdatesPayload from:
```
Return type for `updateSourcedJobPostings`.
```
To:
```
Return type for `clearSourcedJobPostingUpdates`.
```

Changed the description of field ClearSourcedJobPostingUpdatesPayload.results from:

Results for each clear operation.

Array values are non-null, but `jobPosting` can be null if updates were not cleared.

To:

Results for each clear operation.

Array items are never null, but `jobPosting` can be null if nothing was cleared.

Changed the description of type DescriptionFormatting from:
```
Format of the job description content.
```
To:
```
Job description format.
```
Changed the description from:
```
for enum value DescriptionFormatting.HTML changed from HTML format.
```
To:
```
HTML.
```

Changed the description from:

for enum value DescriptionFormatting.TEXT changed from Plain text format. Default if not specified.

To:

Plain text. This is the default.

Changed the description of type EmployerJobIdentifierInput from:

Identifies the employer job by exactly one of: `sourcedPostingId` (UUID) or `employerJobId` (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 returned by `createSourcedJobPostings` or the `EmployerJob` type.

To:

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

Changed the description of field JobsIngestMutations.addSeats from:

Adds new seats to an existing job. Fails if seatPostingId already exists.

To:

Adds seats to a job. Fails if the `seatPostingId` already exists.

Changed the description of field JobsIngestMutations.clearSeats from:
```
Clears/expires seats from an existing job.
```
To:
```
Clears or expires seats from a job.
```
Changed the description of field JobsIngestMutations.clearSourcedJobPostingUpdates from:
```
Clears updates from the `updateSourcedJobPostings` mutation.
```
To:
```
Clears updates made by `updateSourcedJobPostings`.
```
Changed the description of field JobsIngestMutations.updateSeats from:
```
Updates existing seats on a job.
```
To:
```
Updates seats on a job.
```

Changed the description of field JobsIngestMutations.updateSourcedJobPostings from:

Updates a sourced job. The caller must have claimed the job source. Accepts one update per call; multiple updates cause an error.

To:

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

Changed the description of type SeatIdentifierInput from:
```
Identifies a seat by `jobKey`.
```
To:
```
Identifies the seat by `jobKey`.
```

Changed the description of input field SeatIdentifierInput.jobKey from:

Encrypted unique identifier of `jobPostId` corresponding to the seats [JobPost](https://docs.indeed.com/api/job/objects/JobPost). Returned in `addSeats`; also available on [EmployerJobSeatMetaData](https://docs.indeed.com/api/job/objects/EmployerJobSeatMetaData).

To:

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

Changed the description of type SeatJobPostingSalaryInput from:

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

To:

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

Changed the description of input field SeatJobPostingSalaryInput.currency from:
```
Salary currency in ISO 4217 format (such as `USD`).
```
To:
```
Salary currency in ISO 4217 format, such as `USD`.
```

Changed the description of input field SeatLocationInput.cityRegionPostal from:

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 from:
```
Job location latitude.
```
To:
```
Latitude for the job location.
```
Changed the description of input field SeatLocationInput.longitude from:
```
Job location longitude.
```
To:
```
Longitude for the job location.
```
Changed the description of input field SeatLocationInput.streetAddress from:
```
Street address. Example: `1600 Pennsylvania Ave` (USA).
```
To:
```
Street address. Example: `1600 Pennsylvania Ave`.
```

Changed the description of input field SeatTaxonomyInput.attributes from:

Taxonomy attributes ([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 or set to `null` for non-remote jobs.

Values: `Fully Remote`, `Hybrid Remote`.

To:

Location flexibility. Omit this field or set it 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 immediately.

To:

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

Changed the description of field SourcedJobPostingUpdate.employerJobId from:
```
Employer job ID (base64-encoded [IRI](/getstarted/iris)).
```
To:
```
Employer job ID, base64-encoded as an [IRI](/getstarted/iris).
```

Changed the description of type UpdateSeatBodyInput from:

Seat body for an update operation. All fields optional — provide only those changing.

To:

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

Changed the description of type UpdateSeatInput from:
```
Individual seat update operation.
```
To:
```
One seat update operation.
```
Changed the description of input field UpdateSeatInput.employerJob from:
```
Identifies the employer job whose seat is being updated.
```
To:
```
Employer job for the seat.
```
Changed the description of input field UpdateSeatInput.seatIdentifier from:
```
Identifies the seat to update. Provide exactly one field.
```
To:
```
Seat to update. Provide one field.
```
Changed the description of type UpdateSeatMetadataInput from:
```
Seat metadata for an update operation.
```
To:
```
Seat metadata for updating a seat.
```
Changed the description of input field UpdateSeatMetadataInput.taxonomyClassification from:
```
Taxonomy classification for this seat.
```
To:
```
Taxonomy classification for the seat.
```
Changed the description of input field UpdateSeatMetadataInput.trackingUrl from:
```
Tracking URL for this seat. Omit or set to `null` for no change.
```
To:
```
Tracking URL for the seat. Omit or set to `null` for no change.
```
Changed the description of input field UpdateSeatMetadataInput.url from:
```
Seat-specific job URL. Omit or set to `null` for no change.
```
To:
```
Job URL for the seat. Omit or set to `null` for no change.
```
Changed the description of type UpdateSeatResult from:
```
Result for a single seat update operation.
```
To:
```
Result for one seat update.
```
Changed the description of field UpdateSeatResult.seatPostingId from:
```
Agency-provided seat identifier.
```
To:
```
Agency-provided seat ID.
```
Changed the description of type UpdateSeatsInput from:
```
Input for the `updateSeats` mutation.
```
To:
```
`updateSeats` input.
```
Changed the description of input field UpdateSeatsInput.seatUpdates from:
```
Seat updates to process. Accepts exactly one item at this time.
```
To:
```
Seat updates to process. Accepts one item.
```
Changed the description of field UpdateSeatsPayload.results from:
```
Results for each seat update operation.
```
To:
```
Results for each seat update.
```

Changed the description of type UpdateSourcedJobPostingBodyInput from:

Updates the job posting 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 (max 200 characters). Omit or set to null for no change.
```
To:
```
Company name. Maximum 200 characters. Omit or set to `null` for no change.
```

Changed the description of input field UpdateSourcedJobPostingBodyInput.description from:

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

To:

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

Changed the description of input field UpdateSourcedJobPostingBodyInput.jobLocation from:
```
Job location. Omit or set to null for no change.
```
To:
```
Job location. Omit or set to `null` for no change.
```
Changed the description of input field UpdateSourcedJobPostingBodyInput.salary from:
```
Job salary. Omit or set to null for no change.
```
To:
```
Job salary. Omit or set to `null` for no change.
```
Changed the description of input field UpdateSourcedJobPostingBodyInput.title from:
```
Job title (max 75 characters). Omit or set to null for no change.
```
To:
```
Job title. Maximum 75 characters. Omit or set to `null` for no change.
```

Changed the description of input field UpdateSourcedJobPostingGeneralLocationInput.cityRegionPostal from:

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 from:

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 from:

Employer job UUID from `createSourcedJobPostings`. Accepts UUID or base64-encoded IRI from `EmployerJob`.

To:

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

Changed the description of type UpdateSourcedJobPostingLocationInput from:

Job location update. Provide exactly one field or an error occurs.

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 input. Accepts values from `cityRegionPostal` to specific addresses.

Changed the description of type UpdateSourcedJobPostingMetadataInput from:

Job metadata to update. At least one field required.

**Note**: Not atomic. Errors can cause partial updates.

To:

Job metadata to update. Provide at least one field.

Not atomic. Errors can cause partial updates.

Changed the description of input field UpdateSourcedJobPostingMetadataInput.campaignCategories from:
```
Category tags to group jobs for campaigns.
```
To:
```
Category tags for campaign grouping.
```
Changed the description of field UpdateSourcedJobPostingResult.jobPosting from:
```
Job posting for the update. null if the update was not accepted.
```
To:
```
Updated job posting, or null if the update was not accepted.
```

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`. Omit or set to `null` for no change.

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. Omit or set to `null` to clear.
```
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. Omit or set to `null` to clear.
```
Changed the description of type UpdateSourcedJobPostingsInput from:
```
Input for the `updateSourcedJobPostings` mutation.
```
To:
```
`updateSourcedJobPostings` input.
```

Changed the description of field UpdateSourcedJobPostingsPayload.results from:

Results for each update. Array values are non-null, but `jobPosting` is null if the update was not accepted.

To:

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

GraphQL schema change log: 2026-06-29​

Was this page helpful?

GraphQL schema change log: 2026-06-29