• Features
  • Pricing
Get Started

List LabelsCreate LabelGet LabelUpdate LabelDelete LabelReorder Labels

POST /v1/labels/reorder

Persist a new ordering for labels.

POST /v1/labels/reorder stores a new label order.

Authentication

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

Request Body

Send every label ID once, in the order that should be stored.

NameTypeRequiredDescription
labelIdsarray of strings (uuid)YesOrdered label IDs. The array must contain at least one ID.

Example

curl -X POST "https://api.blueputto.com/v1/labels/reorder" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"labelIds":["LABEL_ID_1","LABEL_ID_2"]}'

Success Response

200 OK

{
  "data": {}
}

Error Responses

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

DELETE /v1/labels/{labelId}

Delete a label.

Templates

Reference for listing, creating, retrieving, updating, and deleting templates.

On this page

AuthenticationRequest BodyExampleSuccess ResponseError Responses