Update Role

Updates an existing permissions role’s name and action set.

The update is a full replacement of the role definition.

🚧 Built-in system roles (such as Admin and Member) cannot be updated. Attempting to modify a system role returns an error.

AuthorizationBearer

Bearer user API key

AuthorizationBasic

Basic organization-scoped API key

idstringRequiredformat: "uuid"

This endpoint expects an object.

namestringRequired

organization_idstring or nullOptionalformat: "uuid"

dataobject

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X PUT https://app.polytomic.com/api/permissions/roles/248df4b7-aa70-47b8-a036-33ac447e668d \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Custom"
>	}'

1	{
2	"data": {
3	"id": "248df4b7-aa70-47b8-a036-33ac447e668d",
4	"name": "Custom",
5	"organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
6	"system": false
7	}
8	}

$	curl -X PUT https://app.polytomic.com/api/permissions/roles/248df4b7-aa70-47b8-a036-33ac447e668d \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Custom"
>	}'

1	{
2	"data": {
3	"id": "248df4b7-aa70-47b8-a036-33ac447e668d",
4	"name": "Custom",
5	"organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
6	"system": false
7	}
8	}