[DELETE] Categories

Delete Category

This operation allows you to delete an existing category from the catalog.

It follows REST principles and aligns with the OData v4.01 standard.

[DELETE] Category Endpoint

https://api2.saleslayer.com/rest/Categoría/Categorías({categoryId})

Making a request

  • Use the HTTP method: DELETE.
  • Include the API key in the request headers for authentication.
  • It does not require a body (request body).
  • The categoryId parameter is required and indicates the category you want to delete.

Request example:

DELETE /rest/Catalog/Categories(16)

Response

🟢 204 No content

The category was successfully updated. No additional content is returned.

🔴 400 Bad Request

Common errors include:

  • The provided ID is in an incorrect format (must be numeric).
  • Required parameters are missing or invalid.
"The cat_id is invalid or not found"

🔴 401 Unauthorized

Missing or invalid API key.

🔴 403 Forbidden

The user does not have permission to perform this operation.

🔴 404 Not Found

The category specified by categoryId does not exist.

🔴 412 Precondition Failed

System is not in a valid state to perform the operation.

🔴 500 Internal Server Error

Unexpected system failure

Limitations and considerations

  • Only one category can be deleted per request.
  • Subcategories and linked products are automatically updated to avoid invalid references.
  • Deletion is not supported in environments with multi-table attributes.