Skip to main content
POST
/
organizations
/
roles
Create Role
curl --request POST \
  --url https://api-sandbox.y.uno/v1/organizations/roles \
  --header 'Content-Type: application/json' \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>' \
  --data '
{
  "name": "Operator",
  "description": "Custom operator",
  "permission_ids": [],
  "testing_permission_ids": [],
  "role_type": "account"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "admin": true,
  "permission_ids": [
    "<string>"
  ],
  "testing_permission_ids": [
    "<string>"
  ],
  "role_type": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

Create a custom role for the organization.

Authorizations

PUBLIC-API-KEY
string
header
default:<Your PUBLIC-API-KEY>
required
PRIVATE-SECRET-KEY
string
header
default:<Your PRIVATE-SECRET-KEY>
required

Body

application/json
name
string
required
Maximum string length: 255
Example:

"Operator"

description
string
Maximum string length: 1024
Example:

"Custom operator"

permission_ids
string[]
testing_permission_ids
string[]
role_type
enum<string>
default:account
Available options:
account,
organization

Response

Created

id
string
name
string
description
string | null
admin
boolean
permission_ids
string[]
testing_permission_ids
string[]
role_type
string
created_at
string<date-time>
updated_at
string<date-time>