Actualizar Enum

Actualiza un modelo Enum existente: su nombre y el conjunto completo de valores. Igual que en PUT /model/entity, el body describe el estado final deseado y el servidor lo reconcilia con el enum actual por id de 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.updateEnum(...). Los agentes IA pueden alcanzarlo a través de la tool MCP update-content-island-enum, que ofrece una interfaz declarativa (añadir / renombrar / eliminar) sobre este endpoint.

Cómo funciona la reconciliación

Los values que envías reemplazan la lista de valores del enum, emparejados por id:

• un valor con un id existente → se mantiene; cambia su string value para renombrarlo (la nueva etiqueta se propaga al contenido existente);
• un valor sin id → se añade un nuevo valor al final;
• un valor existente cuyo id está ausente de la lista → se elimina, y se borra de todo el contenido que lo usaba.

Peligro

Omitir un valor lo elimina y lo borra del contenido. Envía siempre la lista de valores completa deseada, manteniendo el id de cada valor que quieras preservar. La tool MCP update-content-island-enum lo calcula por ti con operaciones declarativas addValues / renameValues / removeValueIds y protege las eliminaciones tras un paso de dry-run / confirmación.

Endpoint

shell

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

Path Parameters

Nombre	Tipo	Obligatorio	Descripción
id	string	sí	El id de 24 caracteres del enum a actualizar.

Body

interface UpdateEnumPayload {
  name: string; // nombre del enum (puede renombrar el enum)
  values: EnumValueSpec[]; // la lista de valores completa deseada, emparejada por id
}

interface EnumValueSpec {
  id?: string; // inclúyelo para preservar/renombrar un valor existente; omítelo para añadir uno nuevo
  value: string;
}

Ejemplo

Renombra Size → TshirtSize, renombra el valor S → Small (manteniendo su id), añade XL y elimina L al omitirlo:

shell

curl -X PUT https://api.contentisland.net/api/1.0/model/enum/660f5b8a3a1c2d4e7f8b34cd \
--header 'Authorization: Bearer TU_WRITE_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "name": "TshirtSize",
  "values": [
    { "id": "880b7d0c5c3e4f6a9b0d1234", "value": "Small" },
    { "id": "880b7d0c5c3e4f6a9b0d5678", "value": "M" },
    { "value": "XL" }
  ]
}'

Respuesta

En caso de éxito, el endpoint devuelve 200 OK con el id del enum:

{
  "id": "660f5b8a3a1c2d4e7f8b34cd"
}

Códigos de estado

Código	Descripción
200	El enum se actualizó. El cuerpo de la respuesta contiene el id del enum.
400	Payload inválido — nombre incorrecto, 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.
404	No existe ningún enum con el :id dado en el proyecto.
500	Error interno del servidor.