Actualizar Campo

Actualiza el valor de un único campo de una entrada de contenido existente. Puedes apuntar al campo bien por id del valor de campo, bien por nombre de campo + idioma.

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.updateContentFieldValue(...).

Nota

Al actualizar un valor, el estado del contenido avanza automáticamente (por ejemplo de publicado a cambios pendientes), así que el cambio necesita publicarse para que los consumidores con read token lo vean.

Endpoint

shell

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

Parámetros de ruta

El segmento :id de la URL es obligatorio e identifica qué contenido se va a actualizar.

Nombre	Tipo	Obligatorio	Descripción
id	string	sí	El ID del contenido a actualizar. Puedes encontrarlo en la pestaña Content de tu proyecto, ya sea en el listado o en el detalle del contenido.

Body

El body admite dos formas válidas. Usa la forma nombre de campo + idioma — es la recomendada. La forma id del valor de campo se mantiene por compatibilidad pero está deprecada y puede eliminarse en una versión futura.

Actualizar por nombre de campo + idioma (recomendado)

interface UpdateFieldValueByFieldNamePayload {
  fieldName: string; // nombre del campo según el modelo
  language: LanguageCode; // idioma del valor a actualizar
  value: any; // nuevo valor
}

Nombre	Descripción
fieldName	El nombre del campo tal y como está definido en el modelo (por ejemplo title).
language	El idioma del valor a actualizar. Debe ser uno de los idiomas habilitados en el proyecto.
value	El nuevo valor para el campo.

Actualizar por id del valor de campo (deprecado)

Precaución

Esta forma del payload está deprecada y no se recomienda para nuevas integraciones. Usa la forma nombre de campo + idioma de arriba — es más estable (los nombres de campo rara vez cambian) y no requiere hacer un GET /content previo para descubrir ids internos. La forma id + value puede eliminarse en una versión futura de la API.

interface UpdateFieldValuePayload {
  id: string; // id del valor de campo a actualizar (devuelto por GET /content)
  value: any; // nuevo valor
}

Nombre	Descripción
id	El id del valor de campo existente. Lo puedes obtener del fields[].id devuelto por GET /content.
value	El nuevo valor para el campo. El tipo esperado depende del tipo del campo en el modelo.

Ejemplo

shell

curl -X PUT https://api.contentisland.net/api/1.0/content/660f5b8a3a1c2d4e7f8b9012 \
--header 'Authorization: Bearer TU_WRITE_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "fieldName": "title",
  "language": "es",
  "value": "Hola mundo (actualizado)"
}'

Respuesta

En caso de éxito, el endpoint devuelve 204 No Content con cuerpo vacío.

Códigos de estado

Código	Descripción
204	El campo se actualizó correctamente.
400	Payload inválido (campos faltantes, forma incorrecta, o el language indicado no está configurado en el proyecto).
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 se encontró el contenido, el nombre de campo (usando fieldName) o el valor de campo (usando la forma deprecada id).
500	Error interno del servidor. Se produjo un error al procesar la solicitud.