---
title: "Preview the job code linked fields a bulk update will overwrite, without saving"
method: POST
path: "/v2/org/{orgId}/job/bulkupdate/preview"
tags: ["job"]
---

# Preview the job code linked fields a bulk update will overwrite, without saving

`POST /v2/org/{orgId}/job/bulkupdate/preview`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v2/org/{orgId}/job/bulkupdate/preview`
- Auth: none declared
- TypeScript: <https://skmtc.dev/charthop/apis/charthop-api/docs/v2/org/:orgId/job/bulkupdate/preview/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orgId` string, required

## Query parameters

- `enrichLinkedFields` boolean
- `format` string

## Request body

- BulkJobPersonUpdateRequest
  - `updates` UpdateOperation[], required: list of update operations to perform
    - `jobId` string
    - `personId` string
    - `date` string, date
    - `update` object, required
  - `date` string, date, required: date of update
  - `scenarioId` string: scenario id
  - `note` string: note for update

## Response `200`

success

- BulkJobEnrichmentPreviewResponse
  - `previews` JobEnrichmentPreview[], required: One preview per requested update, in request order
    - `jobId` string: Job id from the request update, echoed for correlation
    - `personId` string: Person id from the request update, echoed for correlation
    - `enrichedFields` object, required: Job code linked fields the update will overwrite, keyed by field id, formatted per the format param
    - `previousFields` object, required: Current values of the enrichedFields keys before the update, keyed by field id, formatted per the format param

## Other responses

- `400`: bad request
- `404`: not found

## Changes

- **2026-11-03** `0ba07a31d48a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/charthop/apis/charthop-api/changes/v2/org/:orgId/job/bulkupdate/preview/post.md)

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) - [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/c4ab2e4f2575?raw)