api.jobs.parcel_items.create

POST /job/{jobDisplayId}/parcelitems — ACPortal

Python

api.jobs.parcel_items.create(job_display_id: int, *, data: ParcelItemCreateRequest | dict) -> ParcelItem

CLI

ab jobs parcel_items create <job_display_id> [--data ...]

Add ONE parcel item, preserving the existing set (ACID get-merge-write).

POST /job/{jobDisplayId}/parcelitems is replace-all (SaveAllParcelItemsRequest): the body’s parcelItems array becomes the ENTIRE set. To avoid wiping the other items, this reads the current parcel items, appends data (an ergonomic single-item

class:

ParcelItemCreateRequest), and saves the full set. Returns the newly added :class:ParcelItem.

Request body — ParcelItemsRequest

Field	Type	Required	Description
jobModifiedDate	Optional[str]	no	Job modified timestamp (optimistic concurrency)
forceUpdate	Optional[bool]	no	Bypass the optimistic-concurrency check
parcelItems	Optional[list[ParcelItemSave]]	no	Full parcel-item set to save

Response

Returns ParcelItemsResponse.

Field	Type	Required	Description
jobModifiedDate	Optional[str]	no	Job modified timestamp
parcelItems	Optional[list[ParcelItem]]	no	Parcel items after the save

---

← Back to api.jobs