Create an role
Create a new role within the organization with specified permissions and settings. This endpoint allows organization administrators to define custom roles with specific access levels and capabilities for member management.
POST
Parameters
Path Parameters
OrganizationId
REQUIRED
Unique identifier of the organization
Body
application/jsonName
REQUIRED
Name for the new role
Description
Optional description explaining the purpose of the role
Permissions
REQUIRED
List of permissions to be assigned to the role
| Status code | Description |
|---|---|
| 200 | Successfully created resource with its unique identifier |
| 400 | Bad request error - the request contains invalid parameters or malformed data |
| 500 | Internal server error - an unexpected error occurred on the server |
cURL
curl -L -X POST \"https://blockv-labs.io/organizations/{organizationId}/roles" \-H 'Accept: application/json'
Response
{"id": "string"}
json
{"type": "object","required": ["id"],"properties": {"id": {"type": "string","description": "Unique identifier of the created resource"}}}