---
title: "PATCH /api/cascade-tracing/orders/sales/bulk-documents-update"
method: PATCH
path: "/api/cascade-tracing/orders/sales/bulk-documents-update"
tags: ["Order Tracing - Sales Orders"]
---

# PATCH /api/cascade-tracing/orders/sales/bulk-documents-update

`PATCH /api/cascade-tracing/orders/sales/bulk-documents-update`

## Request

- Base URL: `https://api.retraced.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retraced.com/api/cascade-tracing/orders/sales/bulk-documents-update`
- Auth: none declared

Queues attaching `attachments` (uploaded file ids with their document type) to each of the caller's sales orders among `ids` (archived ones included); the documents are created in the background. Ids that are not the caller's live sales orders are skipped. 409 `orders_must_have_the_same_attachment_template_ids` when the orders do not all share one attachment template.

## Request body

- object
  - `ids` string[], required
  - `attachments` object[], required
    - `fileId` string, required
    - `type` string, required
    - `name` string
    - `reference` string
    - `description` string

## Response `204`

No content

- 'null', nullable: No content

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `409`: Default Response

## Changes

> 108 revisions in range; 2 not diffed.

- **2026-10-26** `4ac1c961c5f8`: 31 breaking
  - removed the enum value `AFFIDAVITS` of the request property `attachments/items/type`
  - removed the enum value `AUDIT_REPORT` of the request property `attachments/items/type`
  - removed the enum value `BILL_OF_LADING` of the request property `attachments/items/type`
  - removed the enum value `BUSINESS_LICENSE` of the request property `attachments/items/type`
  - …27 more
- **2026-10-11** `363dc33b9509`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/retraced/apis/api-reference/changes/api/cascade-tracing/orders/sales/bulk-documents-update/patch.md)

---

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