Create organization role

Creates a custom organization role with a named permission map.

POST /v1/orgs/{orgId}/roles

Create organization role

cURL

curl --request POST \
  --url https://api.openworklabs.com/v1/orgs/{orgId}/roles \
  --header 'Content-Type: application/json' \
  --data '
{
  "roleName": "<string>",
  "permission": {}
}
'

201

{
  "success": true
}

Path Parameters

orgId · string<typeid> · required

Den TypeID with 'org_' prefix and a 26-character base32 suffix.

Required string length: 30

Pattern: ^org_.*

Body

application/json

roleName · string · required

Required string length: 2 - 64

permission · object · required

Show child attributes

Response

201

application/json

Organization role created successfully.

success · boolean · required