Patch Attribute By Code

Update/create an attribute

PATCH/api/rest/v1/attributes/{code}

Use it in a workflow

Add a step and choose the Akeneo connector.
Pick the Patch Attribute By Code action (under Attribute).
Fill in the fields below, then reference the result from later steps as {{patchAttributeByCode.response.data}}.

Request

Path parameters

codestringrequired

This path parameter is used to specify the unique identifier of the entity you want to retrieve or manipulate. It is essential for identifying the specific entity in the API requests. Ensure that the code is correctly formatted and corresponds to an existing entity in the system.

Request body

Enter the body as JSON in the step's Body field.

codestring

Attribute code

typestring

Attribute type. See [type](https://api.akeneo.com/concepts/catalog-structure.html#attribute) section for more details.

One ofpim_catalog_identifierpim_catalog_metricpim_catalog_numberpim_reference_data_multiselectpim_reference_data_simpleselectpim_catalog_simpleselectpim_catalog_multiselectpim_catalog_datepim_catalog_textareapim_catalog_textpim_catalog_filepim_catalog_imagepim_catalog_price_collectionpim_catalog_booleanakeneo_reference_entityakeneo_reference_entity_collectionpim_catalog_asset_collectionpim_catalog_product_linkpim_catalog_table

labelsobject

Attribute labels for each locale

Default {}

groupstring

Attribute group

group_labelsobject

Group labels for each locale

Default {}

sort_orderinteger

Order of the attribute in its group

Default 0

localizableboolean

Whether the attribute is localizable, i.e. can have one value by locale

Default false

scopableboolean

Whether the attribute is scopable, i.e. can have one value by channel

Default false

available_localesarray<string>

To make the attribute locale specfic, specify here for which locales it is specific

uniqueboolean

Whether two values for the attribute cannot be the same

useable_as_grid_filterboolean

Whether the attribute can be used as a filter for the product grid in the PIM user interface

max_charactersinteger | null

Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`

validation_rulestring | null

Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`

validation_regexpstring | null

Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`

wysiwyg_enabledboolean | null

Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`

number_minstring | null

Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`

number_maxstring | null

Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`

decimals_allowedboolean | null

Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`

negative_allowedboolean | null

Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`

metric_familystring | null

Metric family when the attribute type is `pim_catalog_metric`

default_metric_unitstring | null

Default metric unit when the attribute type is `pim_catalog_metric`

date_minstring | null

Minimum date allowed when the attribute type is `pim_catalog_date`. Accepts a date in `YYYY-MM-DD` format or an ISO 8601 date-time (`YYYY-MM-DDTHH:MM:SS+00:00` or `YYYY-MM-DDTHH:MM:SSZ`).

date_maxstring | null

Maximum date allowed when the attribute type is `pim_catalog_date`. Accepts a date in `YYYY-MM-DD` format or an ISO 8601 date-time (`YYYY-MM-DDTHH:MM:SS+00:00` or `YYYY-MM-DDTHH:MM:SSZ`).

display_timeboolean | null

Whether the time component is displayed and stored for values of this attribute. When `true`, filters on this attribute using `pim_catalog_date` values accept ISO 8601 date-times with time-of-day precision. When `false`, the time component of filter values is ignored (the filter matches the full day).

allowed_extensionsarray<string>

Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`

max_file_sizestring | null

Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`

reference_data_namestring | null

Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`

default_valueoneOf

table_configurationarray<object>

Configuration of the Table attribute (columns)

codestringrequired

Column code

data_typestringrequired

Column data type

One ofselecttextnumberbooleanincremental_numberreference_entityproduct_linkmeasurementdate

validationsobject4 fields

User defined validation constraints on the cell content

Default {}

labelsobject

Column labels for each locale

Default {}

is_required_for_completenessboolean

Defines if the column should be entirely filled for the attribute to be considered complete

Default false

is_main_identifierboolean

Is this attribute main identifier when attribute type is `pim_catalog_identifier`

is_mandatoryboolean

This attribute must be enriched from the moment a product is created. It will be mandatory across all families.

decimal_places_strategystring | null

Defines the decimal places strategy. Available options are `round`, `forbid` and `trim`.

decimal_placesnumber | null

Defines the number of decimal places when decimal places strategy is `round` or `forbid`

enable_option_creation_during_importboolean | null

Whether new attribute options can be created automatically during product or product model import (CSV, XLSX), when the attribute type is `pim_catalog_simpleselect` or `pim_catalog_multiselect`

max_items_countnumber | null

Maximum number of items allowed in an asset collection when the attribute type is `pim_catalog_asset_collection`

json

{
  "code": "release_date",
  "type": "pim_catalog_date",
  "labels": {
    "en_US": "Release date",
    "fr_FR": "Date de sortie"
  },
  "group": "marketing",
  "group_labels": {
    "en_US": "Marketing",
    "fr_FR": "Marketing"
  },
  "sort_order": 1,
  "localizable": false,
  "scopable": false,
  "available_locales": [
    "en_US",
    "fr_FR"
  ],
  "unique": false,
  "useable_as_grid_filter": true,
  "max_characters": 255
}

Response

Returns 201 with a any. Read it in later steps with {{patchAttributeByCode.response.data.<field>}}.

Need more? See the Akeneo guide for connection setup and behaviour shared by every action.

Was this page helpful?