Role Assignments
Bulk Operations

Bulk Unassign Role

delete/v2/facts/{proj_id}/{env_id}/role_assignments/bulk

Request

  • Base URL
    https://api.permit.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

proj_idstring required

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

env_idstring required

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

Request body

rolestring required

the role that will be unassigned (accepts either the role id or the role key)

tenantstring required

the tenant the role is associated with (accepts either the tenant id or the tenant key)

resource_instancestring

the resource instance the role is associated with (accepts either the resource instance id or key using this format resource_type:resource_instance)

userstring required

the user the role will be unassigned from (accepts either the user id or the user key)

Example request

[
  {
    "user": "jane@coolcompany.com",
    "role": "editor",
    "tenant": "google-inc"
  }
]

Response

Successful Response

assignments_removedinteger

Changes

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