POpolytomic
Permissions

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.

post/api/permissions/roles

Request

  • Base URL
    https://app.polytomic.com
  • Auth
    • HTTP bearer
    • or HTTP basic

Headers

X-Polytomic-Versionstring

Request body

namestring required
organization_idstring uuid nullable

Ignored for user and organization-scoped API keys, which always act in their own organization

Example request

{
  "name": "Custom",
  "organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
}

Response

OK

Example response

{
  "data": {
    "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
    "name": "Custom",
    "organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
  }
}

Changes

No recorded changes to this operation across all 51 revisions of this API.