updateContentFieldValue

La función updateContentFieldValue actualiza un único campo de una entrada de contenido existente. Es el equivalente en JavaScript/TypeScript del endpoint REST PUT /content/:id.

Hay dos formas de identificar el campo destino: por nombre de campo + idioma (recomendada) o por id del valor de campo (deprecada).

Ejemplo:

// Recomendado: identificar el campo por nombre + idioma
await client.updateContentFieldValue(contentId, { fieldName: 'title', language: 'es' }, 'Hola mundo (actualizado)');

Precaución

updateContentFieldValue requiere un Write Token como accessToken del cliente. Llamarlo con un read token devuelve 403 Forbidden.

Consejo

Cuando usas el selector fieldName + language, la llamada es un upsert: si no existía aún un valor para ese campo en ese idioma, se crea. Esto hace que la forma con selector sea ideal para añadir traducciones o rellenar nuevos idiomas en contenidos existentes.

Interface

export type FieldSelector = { fieldName: string; language: string };

export interface ApiClient {
  // Overload recomendado
  updateContentFieldValue(contentId: string, selector: FieldSelector, value: unknown): Promise<boolean>;

  // Overload deprecado — usa un FieldSelector en su lugar
  updateContentFieldValue(contentId: string, fieldValueId: string, value: unknown): Promise<boolean>;

  // ... otros métodos
}

Parámetros

Nombre	Descripción
contentId	El ID de la entrada de contenido a actualizar. Puedes encontrarlo en la pestaña Content de tu proyecto, ya sea en el listado o en el detalle del contenido.
selector	Un objeto FieldSelector ({ fieldName, language }, recomendado) o un string con el id del valor de campo (deprecado).
value	El nuevo valor para el campo. El tipo esperado depende del tipo del campo en el modelo.

Actualizar por fieldName + language (recomendado)

await client.updateContentFieldValue(
  '660f5b8a3a1c2d4e7f8b9012',
  { fieldName: 'title', language: 'es' },
  'Hola mundo (actualizado)'
);

Propiedad	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.

Actualizar por id del valor de campo (deprecado)

Precaución

Este overload está deprecado y no se recomienda para nuevas integraciones. Usa el selector fieldName + language — es más estable (los nombres de campo rara vez cambian) y no requiere hacer un getContent previo para descubrir ids internos.

// Deprecado
await client.updateContentFieldValue('660f5b8a3a1c2d4e7f8b9012', 'fieldValueId-1234', 'Hola mundo (actualizado)');

Salida

La función devuelve una Promise<boolean> que indica si la actualización tuvo éxito.

const ok = await client.updateContentFieldValue(
  contentId,
  { fieldName: 'title', language: 'es' },
  'Hola mundo (actualizado)'
);
// ok → true

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