Crear Enum

Crea un nuevo modelo Enum: una lista cerrada y con nombre de valores de texto que los campos de entidad de tipo enum pueden referenciar. El servidor asigna un id al enum y a cada valor.

Precaución

Este endpoint requiere un Write Token en la cabecera Authorization. Llamarlo con un token (de lectura) habitual devuelve 403 Forbidden.

Consejo

Si usas JavaScript o TypeScript, el cliente de la API de Content Island envuelve este endpoint como client.createEnum(...). Los agentes IA pueden alcanzarlo a través de la tool MCP create-content-island-enum. Para apuntar un campo a este enum, consulta POST /model/entity (un campo de tipo enum con el id del enum como relatedModelId).

Endpoint

shell

curl -X POST https://api.contentisland.net/api/1.0/model/enum \
--header 'Authorization: Bearer TU_WRITE_TOKEN' \
--header 'Content-Type: application/json' \
--data '{ ... }'

Body

interface CreateEnumPayload {
  name: string; // nombre del enum (mismas reglas que el nombre de un modelo)
  values: EnumValueSpec[]; // al menos un valor, en orden
}

interface EnumValueSpec {
  id?: string; // omítelo al crear — el servidor asigna uno
  value: string; // la etiqueta del valor
}

Nombre	Descripción
name	El nombre del enum. Mismas reglas de nombres que el nombre de un modelo, único entre los modelos del proyecto.
values	Los valores del enum, en orden. Se requiere al menos un valor. Los valores deben ser únicos dentro del enum (sin distinguir mayúsculas/minúsculas).

Ejemplo

shell

curl -X POST https://api.contentisland.net/api/1.0/model/enum \
--header 'Authorization: Bearer TU_WRITE_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "name": "Size",
  "values": [
    { "value": "S" },
    { "value": "M" },
    { "value": "L" }
  ]
}'

Respuesta

En caso de éxito, el endpoint devuelve 201 Created con el id del nuevo enum:

{
  "id": "660f5b8a3a1c2d4e7f8b34cd"
}

Códigos de estado

Código	Descripción
201	El enum se creó. El cuerpo de la respuesta contiene el id del nuevo enum.
400	Payload inválido — nombre incorrecto (formato / longitud / reservado / duplicado), values vacío, o valores duplicados.
401	No autorizado. El token está ausente, malformado o ha expirado.
403	Prohibido. El token no tiene permisos de escritura — usa un Write Token.
500	Error interno del servidor.