Skip to content
API Reference
/
/
Delete Custom Entity

Delete Custom Entity

Request

Deletes an item of a Custom Entity type, identified by its denominator and item identifier. Returns 204 No Content when the item has been deleted.

Authentication

Requires a valid API key in the X-API-KEY header.

Response

204 No Content — Custom Entity item deleted.

Error Responses

  • 401 Unauthorized — Missing or invalid API key. Returned by the API gateway as { "message": "Unauthorized", "request_id": "d8aafa5b8f3e400b60bea0123dd33317" }.
  • 403 Forbidden — The API key does not have write permissions for this operation.
  • 404 Not Found — Custom Entity denominator or item with the given identifier does not exist.
  • 500 Internal Server Error — Unexpected technical error.

Example

Request:

DELETE /CustomEntities('Brand')/item(42) HTTP/1.1
X-API-KEY: your-api-key-here

Response:

HTTP/1.1 204 No Content
Path
customEntityDenominatorstringrequired

Custom Entity denominator (natural language name from the PIM)

itemIdinteger, (int32)required

Custom Entity item identifier

Headers
X-API-KEYstring

Tenant's API key (required)

Accept-Languagestring

Accept-Language header (not used for delete, accepted for consistency)

DELETE
/CustomEntities('{customEntityDenominator}')/item({itemId})
curl -i -X DELETE \
  'https://api2.saleslayer.com/catalog/CustomEntities('\''{customEntityDenominator}'\'')/item({itemId})' \
  -H 'Accept-Language: string' \
  -H 'X-API-KEY: string'

Responses

No Content

Response
No content