# Assign or revoke a role

**POST /api/v2/roles/{role_uuid}/{action}**

Assign or revoke a role for one or more accounts. The action is determined by the URL parameter.
Optionally scope the assignment to a specific target resource (e.g. a network).
Processing is best-effort: each assignee is processed independently and the response
reports which succeeded and which failed.


## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)


### Path parameters
- **role_uuid** (string)

- **action** (string)
  The action to perform.
- **role** (string)
  The UUID of the role.


### Body: application/json (object)

- **assignees** (array[string(uuid)])
  An array of user UUIDs to assign or revoke the role for.
- **target_type** (string)
  The type of target resource to scope the assignment to.
- **target_uuid** (string(uuid))
  The UUID of the target resource.


## Responses
### 200


#### Body: application/json (object)
- **successful** (array[string])

- **failed** (array)



[Powered by Bump.sh](https://bump.sh)