# Orders

## deleteOrderDocument - Delete order document

 - [DELETE /v1/orders/documents/{channel_document_id}](https://developer.mirakl.com/content/product/connect-channel-platform/rest/connect/openapi3/orders/deleteorderdocument.md): Description

Use this API to delete a document.


Call Frequency

Recommended usage: On each document deletion on the order
Maximum usage: On each document deletion on the order

## updateActionStatus - Update asynchronous action status

 - [PUT /v1/orders/actions/{action_id}](https://developer.mirakl.com/content/product/connect-channel-platform/rest/connect/openapi3/orders/updateactionstatus.md): Description

Updates the final status of an asynchronous action previously initiated through a command event.

## Overview
- When an asynchronous action is requested via command event, an action_id is provided to track the action
- Use this endpoint to report the final outcome (SUCCESS or FAILURE) of the action
- For failed actions, detailed error information must be provided

## Usage Notes
- Update should be sent once the action is fully completed
- Multiple errors can be provided for failed actions
- The action ID must match the one provided in the original command event



Call Frequency

Recommended usage: Send update as soon as the action is completed
Maximum usage: Once per action completion

## updateAnonymizeAfterDate - Update anonymization date for orders

 - [PUT /v1/orders/anonymize-after](https://developer.mirakl.com/content/product/connect-channel-platform/rest/connect/openapi3/orders/updateanonymizeafterdate.md): Description

Updates the anonymization date for orders in the Mirakl Connect platform.
Use this API to indicated after which date orders should be anonymized by Connect.
The anonymization process is irreversible and should be used with caution.



Call Frequency

Recommended usage: Once per order when the anonymization date is set
Maximum usage: Every time the anonymization date needs to be changed

## uploadOrderDocument - Upload order document

 - [POST /v1/orders/{channel_order_id}/documents](https://developer.mirakl.com/content/product/connect-channel-platform/rest/connect/openapi3/orders/uploadorderdocument.md): Description

Use this API to upload a document for an order or its related entities (e.g. returns).


Call Frequency

Recommended usage: On each new document on the order
Maximum usage: On each new document on the order

## upsertOrders - Upsert orders

 - [POST /v1/orders](https://developer.mirakl.com/content/product/connect-channel-platform/rest/connect/openapi3/orders/upsertorders.md): Description

Use this API to synchronize orders with Mirakl Connect.

- The operation is not partially successful: if any order in the payload is invalid, the entire request is rejected.
- This API does not support PATCH operations. All fields must be sent with each upsert request to ensure the complete update of the order data.
- Updates whose channel_updated_at timestamp is older than the value already stored in Connect are silently ignored (anti-replay guard).