Create Role

Creates a new permissions role.

Provide a name for the new role. The role is immediately available for use in permission policies.

To attach the role to resources, create or update a policy using POST /api/permissions/policies.

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

AuthorizationBearer

This is the Polytomic API key

This endpoint expects an object.

namestringRequired

organization_idstring or nullOptionalformat: "uuid"

dataobject

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://app.polytomic.com/api/permissions/roles \
>	-H "X-Polytomic-Version: X-Polytomic-Version" \
>	-H "Content-Type: application/json" \
>	-u "<username>:<password>" \
>	-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 POST https://app.polytomic.com/api/permissions/roles \
>	-H "X-Polytomic-Version: X-Polytomic-Version" \
>	-H "Content-Type: application/json" \
>	-u "<username>:<password>" \
>	-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	}