# Associate Roles

Associate Roles give [Associates](https://docs.commercetools.com/api/projects/business-units.md#associate) controlled access to [Business Units](https://docs.commercetools.com/api/projects/business-units.md#businessunit), [Carts](https://docs.commercetools.com/api/projects/carts.md#cart), [Orders](https://docs.commercetools.com/api/projects/orders.md#order), [Quotes](https://docs.commercetools.com/api/projects/quotes.md#quote), and [Quote Requests](https://docs.commercetools.com/api/projects/quote-requests.md#quoterequest).

Associate Roles provide a way to group granular Permissions and assign them to [Associates](https://docs.commercetools.com/api/projects/business-units.md#associate) within a Business Unit.

## Representations

#### AssociateRole

See API type definition [AssociateRole](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRole).

#### AssociateRoleDraft

See API type definition [AssociateRoleDraft](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleDraft).

#### Permission

See API type definition [Permission](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3APermission).

#### AssociateRolePagedQueryResponse

See API type definition [AssociateRolePagedQueryResponse](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRolePagedQueryResponse).

#### AssociateRoleReference

See API type definition [AssociateRoleReference](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleReference).

#### AssociateRoleKeyReference

See API type definition [AssociateRoleKeyReference](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleKeyReference).

#### AssociateRoleResourceIdentifier

See API type definition [AssociateRoleResourceIdentifier](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleResourceIdentifier).

## Get AssociateRole

### Get AssociateRole by ID

See API endpoint definition [GET /\{projectKey}/associate-roles/\{id}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2F%7Bid%7D%3AGET).

### Get AssociateRole by Key

See API endpoint definition [GET /\{projectKey}/associate-roles/key=\{key}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2Fkey%3D%7Bkey%7D%3AGET).

## Query AssociateRoles

See API endpoint definition [GET /\{projectKey}/associate-roles](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%3AGET).

## Check if AssociateRole exists

### Check if AssociateRole exists by ID

See API endpoint definition [HEAD /\{projectKey}/associate-roles/\{id}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2F%7Bid%7D%3AHEAD).

### Check if AssociateRole exists by Key

See API endpoint definition [HEAD /\{projectKey}/associate-roles/key=\{key}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2Fkey%3D%7Bkey%7D%3AHEAD).

### Check if AssociateRole exists by Query Predicate

See API endpoint definition [HEAD /\{projectKey}/associate-roles](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%3AHEAD).

## Create AssociateRole

See API endpoint definition [POST /\{projectKey}/associate-roles](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%3APOST).

## Update AssociateRole

### Update AssociateRole by ID

See API endpoint definition [POST /\{projectKey}/associate-roles/\{id}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2F%7Bid%7D%3APOST).

### Update AssociateRole by Key

See API endpoint definition [POST /\{projectKey}/associate-roles/key=\{key}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2Fkey%3D%7Bkey%7D%3APOST).

## Update actions

#### Add Permission

See API type definition [AssociateRoleAddPermissionAction](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleAddPermissionAction).

#### Change BuyerAssignable

See API type definition [AssociateRoleChangeBuyerAssignableAction](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleChangeBuyerAssignableAction).

#### Remove Permission

See API type definition [AssociateRoleRemovePermissionAction](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleRemovePermissionAction).

#### Set CustomField

See API type definition [AssociateRoleSetCustomFieldAction](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleSetCustomFieldAction).

#### Set Custom Type

See API type definition [AssociateRoleSetCustomTypeAction](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleSetCustomTypeAction).

#### Set Name

See API type definition [AssociateRoleSetNameAction](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleSetNameAction).

#### Set Permissions

See API type definition [AssociateRoleSetPermissionsAction](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleSetPermissionsAction).

## Delete AssociateRole

### Delete AssociateRole by ID

See API endpoint definition [DELETE /\{projectKey}/associate-roles/\{id}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2F%7Bid%7D%3ADELETE).

### Delete AssociateRole by Key

See API endpoint definition [DELETE /\{projectKey}/associate-roles/key=\{key}](https://docs.commercetools.com/api/projects/associate-roles.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fassociate-roles%2Fkey%3D%7Bkey%7D%3ADELETE).

## Related pages

- [Section overview page](https://docs.commercetools.com/api.md)
- [Previous page: Business Unit Search](https://docs.commercetools.com/api/projects/business-unit-search.md)