Void a label
POST
/v1/items/{barcode}/voidFactory API keyBase URL api.skuflo.io!
This endpoint changes or removes real data. It cannot easily be undone, so check the values before you call it, and use a test factory if you have one.
A voided label is refused at every station.
Try it nowPath parameters#
| Name | Type | Description |
|---|---|---|
barcoderequired | string | The label barcode as your scanner reads it. Send it raw: control characters, symbology prefixes and our QR link are cleaned up for you. |
Body parameters#
| Name | Type | Description |
|---|---|---|
reasonoptional | string, max 300 | · |
Responses#
| Status | Meaning |
|---|---|
| 200 | Success. An example body is in the column on the right. |
Other errors#
| Status | Meaning |
|---|---|
| 401 | No key, or the key is not recognised. |
| 402 | billing_required. Reading always works, but this is a write and stops once a trial ends or a plan is cancelled. |
| 403 | The key is valid but its role cannot do this. |
| 404 | Nothing with that id in your factory. |
| 422 | The body failed validation. The response lists every problem at once. |
| 429 | More than 600 requests a minute. Wait retry-after seconds. |