Delete Enum

Deletes an Enum model from the project’s schema.

Caution

This endpoint requires a Write Token in the Authorization header. Calling it with a regular (read) token returns 403 Forbidden.

Danger

The REST endpoint deletes immediately — there is no dry-run or confirm flag at this layer. For a guarded, preview-then-apply flow, use the delete-content-island-enum MCP tool.

Reference protection

If any entity field of type enum references this enum, the deletion is rejected with 409 CONFLICT and nothing is deleted. There is no force override — remove or repoint the referencing field first, then retry.

Tip

If you’re using JavaScript or TypeScript, the Content Island API client wraps this endpoint as client.deleteEnum(...).

Endpoint

shell

curl -X DELETE https://api.contentisland.net/api/1.0/model/enum/:id \
--header 'Authorization: Bearer YOUR_WRITE_TOKEN'

Path Parameters

Name	Type	Required	Description
id	string	yes	The 24-character id of the enum to delete.

Example

shell

curl -X DELETE https://api.contentisland.net/api/1.0/model/enum/660f5b8a3a1c2d4e7f8b34cd \
--header 'Authorization: Bearer YOUR_WRITE_TOKEN'

Response

On success the endpoint returns 204 No Content with an empty body.

Status Codes

Code	Description
204	The enum was deleted.
401	Unauthorized. The token is missing, malformed or expired.
403	Forbidden. The token does not have write permissions — use a Write Token.
404	No enum with the given :id exists in the project.
409	The enum is referenced by an entity field and cannot be deleted. Remove the reference first.
500	Internal server error.