Update Field

Updates the value of a single field on an existing content entry. You can target the field either by field value id or by field name + language.

Caution

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

Tip

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

Note

Updating a field value automatically advances the content’s status (e.g. from published to pending changes), so the change needs to be published to become visible to read-token consumers.

Endpoint

shell

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

Path Parameters

The :id segment in the URL is required and identifies which content entry to update.

Name	Type	Required	Description
id	string	yes	The ID of the content entry to update. You can find it in your project’s Content tab, either in the list or in the content details.

Body

The body has two valid shapes. Use the field name + language form — it’s the recommended one. The field value id form is kept for backwards compatibility but is deprecated and may be removed in a future version.

Update by field name + language (recommended)

interface UpdateFieldValueByFieldNamePayload {
  fieldName: string; // field name as defined in the model
  language: LanguageCode; // language of the value to update
  value: any; // new value
}

Name	Description
fieldName	The name of the field as defined in the model (e.g. title).
language	The language of the value being updated. Must be one of the languages enabled on the project.
value	The new value for the field.

Update by field value id (deprecated)

Caution

This payload shape is deprecated and not recommended for new integrations. Prefer the fieldName + language form above — it is more stable (field names rarely change) and doesn’t require a prior GET /content to discover internal ids. The id + value form may be removed in a future version of the API.

interface UpdateFieldValuePayload {
  id: string; // id of the field value to update (returned by GET /content)
  value: any; // new value
}

Name	Description
id	The id of the existing field value. You can obtain it from the fields[].id returned by GET /content.
value	The new value for the field. The expected type depends on the field’s type in the model.

Example

shell

curl -X PUT https://api.contentisland.net/api/1.0/content/660f5b8a3a1c2d4e7f8b9012 \
--header 'Authorization: Bearer YOUR_WRITE_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "fieldName": "title",
  "language": "en",
  "value": "Hello world (updated)"
}'

Response

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

Status Codes

Code	Description
204	The field was updated successfully.
400	Invalid payload (missing fields, wrong shape, or the supplied language is not configured in the project).
401	Unauthorized. The token is missing, malformed or expired.
403	Forbidden. The token does not have write permissions — use a Write Token.
404	The content, the field name (when using fieldName) or the field value (when using the deprecated id form) was not found.
500	Internal server error. An error occurred while processing the request.