API ReferencePermissionsRoles

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.

Authentication

AuthorizationBasic

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

OR
AuthorizationBearer
This is the Polytomic API key

Headers

X-Polytomic-VersionstringRequired

Request

This endpoint expects an object.
namestringRequired
organization_idstring or nullOptionalformat: "uuid"

Response

OK
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error