• Features
  • Pricing
Get Started

List CategoriesCreate CategoryGet CategoryUpdate CategoryDelete CategoryReorder Categories

POST /v1/categories/reorder

Persist a new ordering for categories.

POST /v1/categories/reorder stores a new category order.

Authentication

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

Request Body

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

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

Example

curl -X POST "https://api.blueputto.com/v1/categories/reorder" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"categoryIds":["CATEGORY_ID_1","CATEGORY_ID_2"]}'

Success Response

200 OK

{
  "data": {}
}

Error Responses

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

DELETE /v1/categories/{categoryId}

Delete a category.

Statuses

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

On this page

AuthenticationRequest BodyExampleSuccess ResponseError Responses