Update Company Role

PUT

https://api-b2b.bigcommerce.com/api/v3/io/companies/roles/:roleId

Updates the name and permissions of a custom Company user role. You cannot update predefined roles. When formatting the request body, you must add all permissions that you wish to keep in the role, including its existing permissions. See [Permission Codes](/developer/api-reference/rest/b2b/management/company/companies#permission-codes) for a list of predefined permission `name` and `code` values.

Update Company Role

PUT

https://api-b2b.bigcommerce.com/api/v3/io/companies/roles/:roleId

Updates the name and permissions of a custom Company user role. You cannot update predefined roles.

When formatting the request body, you must add all permissions that you wish to keep in the role, including its existing permissions. See Permission Codes for a list of predefined permission name and code values.

Authentication

X-Auth-Tokenstring

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

For example requests and more information about authenticating BigCommerce APIs, see Authentication and Example Requests.

For more about BigCommerce OAuth scopes, see our Guide to API Accounts.

For a list of API status codes, see API Status Codes.

X-Store-Hashstring

| Header | Argument | Description | |:-------|:---------|:------------| | `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |

Path parameters

roleIdintegerRequired

The unique identifier for a Company user role.

Request

This endpoint expects an object.

namestringRequired<=200 characters

The name of the Company user role. This name is visible to system users and Company users.

permissionslist of objectsRequired

Response

codeinteger

dataobject

metaobject

$	curl -X PUT https://api-b2b.bigcommerce.com/api/v3/io/companies/roles/123456 \
>	-H "X-Auth-Token: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "io test",
>	"permissions": [
>	{
>	"code": "get_addresses",
>	"permissionLevel": 2
>	}
>	]
>	}'

1	{
2	"code": 200,
3	"data": {
4	"id": 1,
5	"name": "Procurement Manager",
6	"roleType": 2,
7	"roleLevel": 1,
8	"permissions": [
9	{
10	"id": 1,
11	"code": "get_addresses",
12	"permissionLevel": 2
13	}
14	]
15	},
16	"meta": {
17	"message": "SUCCESS"
18	}
19	}

$	curl -X PUT https://api-b2b.bigcommerce.com/api/v3/io/companies/roles/123456 \
>	-H "X-Auth-Token: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "io test",
>	"permissions": [
>	{
>	"code": "get_addresses",
>	"permissionLevel": 2
>	}
>	]
>	}'

1	{
2	"code": 200,
3	"data": {
4	"id": 1,
5	"name": "Procurement Manager",
6	"roleType": 2,
7	"roleLevel": 1,
8	"permissions": [
9	{
10	"id": 1,
11	"code": "get_addresses",
12	"permissionLevel": 2
13	}
14	]
15	},
16	"meta": {
17	"message": "SUCCESS"
18	}
19	}