Detach Assets from Order

Note

Beta. The order asset management endpoints are in active development. The request and response shapes shown here are stable for production use, but we may add new fields or capabilities without notice. Contact support to be notified of breaking changes.

Remove assets that were previously attached to an order via Attach Assets to Order. This only affects custom (order-level) assets — product-level assets linked through digital products are not affected.

Path parameters

• id (string, path, required)

  The order’s unique identifier (UUID).

Request body

• asset_ids (array, required)

  An array of asset UUIDs to detach from the order. IDs that are not currently attached are silently ignored.

Response

Returns 204 No Content on success.

Example request

curl -X DELETE 'https://app.filemonk.io/api/v1/external/orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890/detach_assets' \
  -H 'X-Auth-Token: fm_api_key_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "asset_ids": ["f1e2d3c4-b5a6-7890-fedc-ba0987654321"]
  }'

const orderId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
const response = await fetch(
  `https://app.filemonk.io/api/v1/external/orders/${orderId}/detach_assets`,
  {
    method: 'DELETE',
    headers: {
      'X-Auth-Token': 'fm_api_key_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      asset_ids: ['f1e2d3c4-b5a6-7890-fedc-ba0987654321']
    })
  }
);
// 204 No Content on success

order_id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
response = requests.delete(
    f'https://app.filemonk.io/api/v1/external/orders/{order_id}/detach_assets',
    headers={'X-Auth-Token': 'fm_api_key_your_key_here'},
    json={
        'asset_ids': ['f1e2d3c4-b5a6-7890-fedc-ba0987654321']
    }
)
# 204 No Content on success

Example response

{
  "error": "No custom assets attached to this order"
}

{
  "error": "asset_ids must be a non-empty array"
}