POST /v1/roles
TenantService_CreateRole
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
No path or query parameters.
Request body
codestringdescriptionstringnamestringpermissionsarray
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/roles' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"code": "<value>",
"description": "<value>",
"name": "<value>",
"permissions": [
"<value>"
]
}'Response contract
200 · OK
codestringdescriptionstringidstringis_systembooleannamestringpermissionsarraystatusstringversionstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.