Create Role

Create a new custom role for project.

A role bundles one or more policies and is assigned to users to control what they can do — this is Norbix's role-based access control (RBAC). Roles are project-scoped and managed in the Membership module. This method creates the role; the response returns its id.

This method is on the Hub surface (norbix.hub.membership) — call it from admin tooling or IaC.

These examples assume the SDK is installed and your credentials are set as environment variables — each client reads them automatically, so the constructors below take no arguments. See Install a Norbix SDK.

JavaScript / TypeScript

import { Norbix } from '@norbix.ai/ts';
const norbix = new Norbix();

const result = await norbix.hub.membership.createRole({
  roleName: 'content-editor',
  description: 'Can create and edit content, but not manage billing or members.',
  policies: ['pol_7Uhn615iG5KLwiIYGkxSIG', 'pol_1k4ufY10onE6beVi6Hp7I3'],
});

.NET

using Norbix.Sdk;
using Norbix.Sdk.Types.Hub;

using var client = new NorbixClient();

var result = await client.Membership.CreateRoleAsync(new CreateRole
{
    RoleName = "content-editor",
    Description = "Can create and edit content, but not manage billing or members.",
    Policies = new[] { "pol_7Uhn615iG5KLwiIYGkxSIG", "pol_1k4ufY10onE6beVi6Hp7I3" },
});

Python

from norbix_python import NorbixHub

norbix = NorbixHub()

result = norbix.membership.create_role(
    roleName="content-editor",
    description="Can create and edit content, but not manage billing or members.",
    policies=["pol_7Uhn615iG5KLwiIYGkxSIG", "pol_1k4ufY10onE6beVi6Hp7I3"],
)

Go

c, _ := norbix.New(norbix.Options{})
ctx := context.Background()

var result map[string]any
err := c.Hub.Membership.CreateRole(ctx, map[string]any{
	"roleName": "content-editor",
	"description": "Can create and edit content, but not manage billing or members.",
	"policies": []string{"pol_7Uhn615iG5KLwiIYGkxSIG", "pol_1k4ufY10onE6beVi6Hp7I3"},
}, &result)

Dart / Flutter

import 'package:norbix/norbix_hub.dart';

final hub = NorbixHub();

final result = await hub.membership.createRole(body: {
  'roleName': 'content-editor',
  'description': 'Can create and edit content, but not manage billing or members.',
  'policies': ['pol_7Uhn615iG5KLwiIYGkxSIG', 'pol_1k4ufY10onE6beVi6Hp7I3'],
});

Swift

import NorbixSwift

let client = Norbix()

let result = try await client.hub.membership.createRole([
    "roleName": "content-editor",
    "description": "Can create and edit content, but not manage billing or members.",
    "policies": ["pol_7Uhn615iG5KLwiIYGkxSIG", "pol_1k4ufY10onE6beVi6Hp7I3"],
])

Kotlin

import dev.norbix.sdk.hub.NorbixHub

val hub = NorbixHub()

val result = hub.membership.createRole(mapOf(
    "roleName" to "content-editor",
    "description" to "Can create and edit content, but not manage billing or members.",
    "policies" to listOf("pol_7Uhn615iG5KLwiIYGkxSIG", "pol_1k4ufY10onE6beVi6Hp7I3"),
))

CLI

norbix raw '/{version}/membership/roles' -X POST --body '{"roleName":"content-editor","description":"Can create and edit content, but not manage billing or members.","policies":["pol_7Uhn615iG5KLwiIYGkxSIG","pol_1k4ufY10onE6beVi6Hp7I3"]}'

In the dashboard

Manage this visually in Norbix Cloud — see Membership → Roles.

API reference

Full request and response for this endpoint: Create Role.