commercetools icon

commercetools

Interact with the commercetools API. Operations are auto-generated from the official Postman collection.

Actions671

Associate-role → Update AssociateRole by Key

AI-generated

Summary

Update an AssociateRole in commercetools by its unique key, applying specified update actions to modify its properties.

Inputs

  • Associate-role Key (required) — The unique key of the AssociateRole to update.
  • Version (required) — Current version number of the AssociateRole for concurrency control.
  • Actions (UI) — A set of predefined update actions selected via the user interface to modify the AssociateRole (e.g., add or remove permissions, change buyer assignable flag, set custom fields or types, update name).
  • Actions (JSON) — A raw JSON array of update actions that overrides the UI actions if provided, allowing for advanced custom updates.

Output shape

a single json object representing the updated AssociateRole resource as returned by the commercetools API

The operation requires the correct version to prevent conflicts, and update actions must conform to commercetools API specifications. Errors thrown on failure unless 'Continue On Fail' is enabled.

Examples

Example 1: Modify permissions and assignability of an AssociateRole

Specify the Associate-role Key and version, then add 'AddPermission' and/or 'RemovePermission' actions and set 'Buyer Assignable' flag via UI actions.

Links

Discussion