---
title: "cancelOps order"
method: POST
path: "/ops/orders/{id}/cancel"
tags: ["ops"]
---

# cancelOps order

`POST /ops/orders/{id}/cancel`

Cancel an order in our ops tool

## Path parameters

- `id` string, regexp, required — topi order ID

## Response `200`

OK response.

- OrderResult — Basic information about an order
  - `assets` Asset[], required — A list of assets in an offer
    - `belongs_to_asset_id` string, regexp — reference to parent asset ID, if this asset is a child
    - `id` string, regexp, required — asset ID
    - `offer_line_id` string, regexp — reference to the originating offer_line
    - `product_id` string, regexp, required — product id inside the topi catalog
    - `requires_serial_number` boolean — if the asset requires a serial number
    - `seller_product_references` SellerProductReference[], required — All seller's own references for this asset
      - `reference` string, required — The ID related with the source. This value should be unique for that source.
      - `source` string, required — The seller internal source name for this reference type.
    - `serial_number` string — This is an id that identifies this asset as unique
    - `status` 'created' | 'shipped' | 'return_completed' | 'purchased' | 'return_in_progress' | 'upgrade_in_progress' | 'purchase_in_progress' | 'upgrade_in_progress_in_term' | 'return_in_progress_in_term' | 'ops_canceled' | 'ending_soon' | 'overdue', required
    - `title` string, required — The name of the asset
    - `tracking_url` string — the tracking url of this specific asset
  - `id` string, regexp, required — topi order ID
  - `metadata` object — Metadata you can attach to and order. You can store here any JSON information
  - `offer_id` string, regexp, required — Reference to the topi offer ID
  - `seller_offer_reference` string, required — Seller’s own reference for this order
  - `status` 'created' | 'confirmed' | 'acknowledged' | 'accepted' | 'partially_fulfilled' | 'completed' | 'canceled' | 'rejected', required

## Other responses

- `400` — BadRequest: Bad Request response.
- `401` — Unauthorized: Unauthorized response.
- `403` — InvalidScopes: Forbidden response.
- `404` — NotFound: Not Found response.
- `422` — InvalidStatus: Unprocessable Entity response.

---

[API](https://skmtc.net/topi/apis/topi-public-api.md) · [All operations](https://skmtc.net/topi/apis/topi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topi/topi-public-api/versions/fa134b7fc959/schema)