• Features
  • Pricing
Get Started

List StatusesCreate StatusGet StatusUpdate StatusDelete StatusReorder Statuses

POST /v1/statuses/reorder

Persist a new ordering for statuses.

POST /v1/statuses/reorder stores a new status order.

Authentication

Send an organization API key in x-api-key or Authorization: Bearer <key>.

Request Body

Send every status ID once, in the order that should be stored for one status type.

NameTypeRequiredDescription
typeenumYesin-storage, on-display, temporarily-unavailable, or offsite.
statusIdsarray of strings (uuid)YesOrdered status IDs. The array must contain at least one ID.

Example

curl -X POST "https://api.blueputto.com/v1/statuses/reorder" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"type":"on-display","statusIds":["STATUS_ID_1","STATUS_ID_2"]}'

Success Response

200 OK

{
  "data": {}
}

Error Responses

  • 400 Bad Request
  • 401 Unauthorized
  • 429 Too Many Requests

DELETE /v1/statuses/{statusId}

Delete a status.

Labels

Reference for listing, creating, retrieving, updating, deleting, and reordering labels.

On this page

AuthenticationRequest BodyExampleSuccess ResponseError Responses