2026-06-29

GraphQL schema change log: 2026-06-29

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

[log] ✔ Description:
```
Seat body for an add operation.
```
On type AddSeatBodyInput has changed to:
```
Seat body for adding a seat.
```
[log] ✔ Input field AddSeatBodyInput.location description changed from:
```
Complete location information.
```
To:
```
Location for the seat.
```
[log] ✔ Input field AddSeatBodyInput.salary description changed from:
```
Salary specific to this seat.
```
To:
```
Salary for the seat.
```
[log] ✔ Description:
```
Individual seat add operation.
```
On type AddSeatInput has changed to:
```
One seat add operation.
```
[log] ✔ Input field AddSeatInput.employerJob description changed from:
```
Identifies the employer job to add the seat to.
```
To:
```
Employer job for the seat.
```

[log] ✔ Input field AddSeatInput.seatPostingId description changed 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.

[log] ✔ Description:
```
Seat metadata for an add operation.
```
On type AddSeatMetadataInput has changed to:
```
Seat metadata for adding a seat.
```
[log] ✔ Input field AddSeatMetadataInput.taxonomyClassification description changed from:
```
Taxonomy classification for this seat.
```
To:
```
Taxonomy classification for the seat.
```
[log] ✔ Input field AddSeatMetadataInput.trackingUrl description changed from:
```
Tracking URL for this seat.
```
To:
```
Tracking URL for the seat.
```
[log] ✔ Input field AddSeatMetadataInput.url description changed from:
```
Seat-specific job URL.
```
To:
```
Job URL for the seat.
```
[log] ✔ Description:
```
Result for a single seat add operation.
```
On type AddSeatResult has changed to:
```
Result for one seat add operation.
```

[log] ✔ Field AddSeatResult.jobKey description changed 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.

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

[log] ✔ Description:

Clears all updates from the `updateSourcedJobPostings` mutation.

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

On type ClearSourcedJobPostingUpdateInput has changed to:

Clears updates from `updateSourcedJobPostings`.

Not atomic. Errors can partially clear updates.

[log] ✔ Input field ClearSourcedJobPostingUpdateInput.sourcedPostingId description changed 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).

[log] ✔ Field ClearSourcedJobPostingUpdateResult.jobPosting description changed from:
```
Job posting that was cleared. null if no updates were cleared.
```
To:
```
The cleared job posting, or null if nothing was cleared.
```
[log] ✔ Description:
```
Input for the `clearSourcedJobPostingUpdates` mutation.
```
On type ClearSourcedJobPostingUpdatesInput has changed to:
```
`clearSourcedJobPostingUpdates` input.
```
[log] ✔ Description:
```
Return type for `updateSourcedJobPostings`.
```
On type ClearSourcedJobPostingUpdatesPayload has changed to:
```
Return type for `clearSourcedJobPostingUpdates`.
```

[log] ✔ Field ClearSourcedJobPostingUpdatesPayload.results description changed 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.

[log] ✔ Description:
```
Format of the job description content.
```
On type DescriptionFormatting has changed to:
```
Job description format.
```
[log] ✔ Description:
```
for enum value DescriptionFormatting.HTML changed from HTML format.
```
To:
```
HTML.
```

[log] ✔ Description:

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

To:

Plain text. This is the default.

[log] ✔ Description:

Identifies the employer job by exactly one of: `sourcedPostingId` (UUID) or `employerJobId` (base64-encoded IRI).

On type EmployerJobIdentifierInput has changed to:

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

[log] ✔ Input field EmployerJobIdentifierInput.employerJobId description changed 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`.

[log] ✔ Field JobsIngestMutations.addSeats description changed 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.

[log] ✔ Field JobsIngestMutations.clearSeats description changed from:
```
Clears/expires seats from an existing job.
```
To:
```
Clears or expires seats from a job.
```
[log] ✔ Field JobsIngestMutations.clearSourcedJobPostingUpdates description changed from:
```
Clears updates from the `updateSourcedJobPostings` mutation.
```
To:
```
Clears updates made by `updateSourcedJobPostings`.
```
[log] ✔ Field JobsIngestMutations.updateSeats description changed from:
```
Updates existing seats on a job.
```
To:
```
Updates seats on a job.
```

[log] ✔ Field JobsIngestMutations.updateSourcedJobPostings description changed 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.

[log] ✔ Description:
```
Identifies a seat by `jobKey`.
```
On type SeatIdentifierInput has changed to:
```
Identifies the seat by `jobKey`.
```

[log] ✔ Input field SeatIdentifierInput.jobKey description changed 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`.

[log] ✔ Description:

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

On type SeatJobPostingSalaryInput has changed to:

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

[log] ✔ Input field SeatJobPostingSalaryInput.currency description changed from:
```
Salary currency in ISO 4217 format (such as `USD`).
```
To:
```
Salary currency in ISO 4217 format, such as `USD`.
```

[log] ✔ Input field SeatLocationInput.cityRegionPostal description changed 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 東京都千代田区丸の内`.

[log] ✔ Input field SeatLocationInput.latitude description changed from:
```
Job location latitude.
```
To:
```
Latitude for the job location.
```
[log] ✔ Input field SeatLocationInput.longitude description changed from:
```
Job location longitude.
```
To:
```
Longitude for the job location.
```
[log] ✔ Input field SeatLocationInput.streetAddress description changed from:
```
Street address. Example: `1600 Pennsylvania Ave` (USA).
```
To:
```
Street address. Example: `1600 Pennsylvania Ave`.
```

[log] ✔ Input field SeatTaxonomyInput.attributes description changed 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.

[log] ✔ Input field SeatTaxonomyInput.remoteType description changed 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`.

[log] ✔ Description:

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

On type SourcedJobPostingUpdate has changed to:

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

[log] ✔ Field SourcedJobPostingUpdate.employerJobId description changed from:
```
Employer job ID (base64-encoded [IRI](/getstarted/iris)).
```
To:
```
Employer job ID, base64-encoded as an [IRI](/getstarted/iris).
```

[log] ✔ Description:

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

On type UpdateSeatBodyInput has changed to:

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

[log] ✔ Description:
```
Individual seat update operation.
```
On type UpdateSeatInput has changed to:
```
One seat update operation.
```
[log] ✔ Input field UpdateSeatInput.employerJob description changed from:
```
Identifies the employer job whose seat is being updated.
```
To:
```
Employer job for the seat.
```
[log] ✔ Input field UpdateSeatInput.seatIdentifier description changed from:
```
Identifies the seat to update. Provide exactly one field.
```
To:
```
Seat to update. Provide one field.
```
[log] ✔ Description:
```
Seat metadata for an update operation.
```
On type UpdateSeatMetadataInput has changed to:
```
Seat metadata for updating a seat.
```
[log] ✔ Input field UpdateSeatMetadataInput.taxonomyClassification description changed from:
```
Taxonomy classification for this seat.
```
To:
```
Taxonomy classification for the seat.
```
[log] ✔ Input field UpdateSeatMetadataInput.trackingUrl description changed 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.
```
[log] ✔ Input field UpdateSeatMetadataInput.url description changed 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.
```
[log] ✔ Description:
```
Result for a single seat update operation.
```
On type UpdateSeatResult has changed to:
```
Result for one seat update.
```
[log] ✔ Field UpdateSeatResult.seatPostingId description changed from:
```
Agency-provided seat identifier.
```
To:
```
Agency-provided seat ID.
```
[log] ✔ Description:
```
Input for the `updateSeats` mutation.
```
On type UpdateSeatsInput has changed to:
```
`updateSeats` input.
```
[log] ✔ Input field UpdateSeatsInput.seatUpdates description changed from:
```
Seat updates to process. Accepts exactly one item at this time.
```
To:
```
Seat updates to process. Accepts one item.
```
[log] ✔ Field UpdateSeatsPayload.results description changed from:
```
Results for each seat update operation.
```
To:
```
Results for each seat update.
```

[log] ✔ Description:

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

On type UpdateSourcedJobPostingBodyInput has changed to:

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

[log] ✔ Input field UpdateSourcedJobPostingBodyInput.companyName description changed 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.
```

[log] ✔ Input field UpdateSourcedJobPostingBodyInput.description description changed 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.

[log] ✔ Input field UpdateSourcedJobPostingBodyInput.jobLocation description changed from:
```
Job location. Omit or set to null for no change.
```
To:
```
Job location. Omit or set to `null` for no change.
```
[log] ✔ Input field UpdateSourcedJobPostingBodyInput.salary description changed from:
```
Job salary. Omit or set to null for no change.
```
To:
```
Job salary. Omit or set to `null` for no change.
```
[log] ✔ Input field UpdateSourcedJobPostingBodyInput.title description changed 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.
```

[log] ✔ Input field UpdateSourcedJobPostingGeneralLocationInput.cityRegionPostal description changed 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`.

[log] ✔ Input field UpdateSourcedJobPostingGeneralLocationInput.streetAddress description changed from:

Street address of the job location.

Example: 1600 Pennsylvania Ave (USA) to Street address of the job location.

Example: `1600 Pennsylvania Ave`.

[log] ✔ Input field UpdateSourcedJobPostingInput.sourcedPostingId description changed 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`.

[log] ✔ Description:
```
Job location update. Provide exactly one field or an error occurs.
```
On type UpdateSourcedJobPostingLocationInput has changed to:
```
Job location update. Provide one field or the API returns an error.
```

[log] ✔ Input field UpdateSourcedJobPostingLocationInput.general description changed from:

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

To:

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

[log] ✔ Description:

Job metadata to update. At least one field required.

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

On type UpdateSourcedJobPostingMetadataInput has changed to:

Job metadata to update. Provide at least one field.

Not atomic. Errors can cause partial updates.

[log] ✔ Input field UpdateSourcedJobPostingMetadataInput.campaignCategories description changed from:
```
Category tags to group jobs for campaigns.
```
To:
```
Category tags for campaign grouping.
```
[log] ✔ Field UpdateSourcedJobPostingResult.jobPosting description changed 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.
```

[log] ✔ Input field UpdateSourcedJobPostingSalaryInput.currency description changed 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.

[log] ✔ Input field UpdateSourcedJobPostingSalaryInput.maximumMinor description changed 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.
```
[log] ✔ Input field UpdateSourcedJobPostingSalaryInput.minimumMinor description changed 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.
```
[log] ✔ Description:
```
Input for the `updateSourcedJobPostings` mutation.
```
On type UpdateSourcedJobPostingsInput has changed to:
```
`updateSourcedJobPostings` input.
```

[log] ✔ Field UpdateSourcedJobPostingsPayload.results description changed 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