• Features
  • Pricing
Get Started

List CategoriesCreate CategoryGet CategoryUpdate CategoryDelete CategoryReorder Categories

Categories

PATCH /v1/categories/{categoryId}

Partially update a category with a JSON request body.

PATCH /v1/categories/{categoryId} updates an existing category.

Authentication

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

Path Parameters

NameTypeDescription
categoryIdstring (uuid)UUID of the category to update.

Request Body

Send a JSON object containing the fields you want to change. The public OpenAPI schema keeps the category payload flexible and does not enumerate the exact keys.

Example

curl -X PATCH "https://api.blueputto.com/v1/categories/CATEGORY_ID" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{}'

Success Response

200 OK

{
  "data": {}
}

Error Responses

  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found
  • 429 Too Many Requests

GET /v1/categories/{categoryId}

Retrieve a single category by its UUID.

DELETE /v1/categories/{categoryId}

Delete a category.

On this page

AuthenticationPath ParametersRequest BodyExampleSuccess ResponseError Responses