---
title: "PUT /api/cascade-tracing/orders/toggle-archive"
method: PUT
path: "/api/cascade-tracing/orders/toggle-archive"
tags: ["Order Tracing - Orders"]
---

# PUT /api/cascade-tracing/orders/toggle-archive

`PUT /api/cascade-tracing/orders/toggle-archive`

## 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/toggle-archive`
- Auth: none declared

Archives (`isArchived: true`) or unarchives the given purchase and sales orders of the caller's company, with their shadow Order Hub orders, in one transaction. Ids of orders that are not the caller's are left alone, without an error.

## Request body

- object
  - `isArchived` boolean, required
  - `purchaseOrderIds` string[], nullable
  - `salesOrderIds` string[], nullable

## Response `204`

No content

- 'null', nullable: No content

## Other responses

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

## Changes

> 108 revisions in range; 2 not diffed.

- **2026-10-09** `ddfec192e804`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/retraced/apis/api-reference/changes/api/cascade-tracing/orders/toggle-archive/put.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)