| Field | Type | Required | Description |
|---|---|---|---|
name |
String | ✔️ | The name of the new role set |
key |
Optional<String> | ➖ | A unique key for the role set. Must start with 'role_set:' and contain only lowercase alphanumeric characters and underscores. If not provided, a key will be generated from the name. |
description |
JsonNullable<String> | ➖ | Optional description for the role set |
defaultRoleKey |
String | ✔️ | The key of the role to use as the default role for new organization members. Must be one of the roles in the roles array. |
creatorRoleKey |
String | ✔️ | The key of the role to assign to organization creators. Must be one of the roles in the roles array. |
type |
Optional<Type> | ➖ | The type of the role set. "initial" role sets are the default for new organizations. Only one role set can be "initial" per instance. |
roles |
List<String> | ✔️ | Array of role keys to include in the role set. Must contain at least one role and no more than 10 roles. |