Update Category

Updates an existing category.

PUThttps://api.tracksales.co/v1/categories/{uuid}

Required scope: categories:update

Request URL: https://api.tracksales.co/v1/categories/{uuid}

Path Params

uuidstringrequired

Category UUID

Body Params

namestringrequired

Category name

displayOnSalesGridboolean

Show category on the POS sales grid (default true)

Responses

200OK

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Category was not found.

422Validation Error

Request validation failed.

curl -X PUT 'https://api.tracksales.co/v1/categories/{uuid}' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Electronics","displayOnSalesGrid":true}'

{
    "success": true,
    "data": {
        "id": "770e8400-e29b-41d4-a716-446655440003",
        "name": "Electronics",
        "displayOnSalesGrid": true,
        "lastModified": "2026-07-14"
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Category not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}