POST /sites/{site_id}/components/{component_id}/properties

Update the default property values of a component definition in a specificed locale.

Before making updates, use the get component properties endpoint to identify properties that can be updated in a secondary locale.

The request requires a secondary locale ID. If a localeId is missing, the request will not be processed and will result in an error.

Required scope | components:write

Servers

Path parameters

Name Type Required Description
site_id String Yes

Unique identifier for a Site

component_id String Yes

Unique identifier for a Component

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Query parameters

Name Type Required Description
localeId String No

Unique identifier for a specific locale. Applicable, when using localization.

Request body fields

Name Type Required Description
properties[] Array Yes

A list of component properties to update within the specified secondary locale.

properties[].text String Yes

The new string or HTML value used to update the component property in the secondary locale.

The provided value must be compatible with the type of the component property.

For example, attempting to update a single-line plain-text property with a multi-line value will result in an error.

properties[].propertyId String Yes

The ID of the property.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.