Create Policy

Create a new custom policy for project.

A policy is a reusable set of permissions (allow/deny rules over modules and actions). Policies are attached to roles; a user's effective permissions are the union of the policies on all their roles. This method creates the policy; 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.createPolicy({
  policyName: 'articles-editor',
  description: 'Read and write access to the articles collection.',
  policyDocumentJson: '{"allow":["articles:read","articles:write"]}',
});

.NET

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

using var client = new NorbixClient();

var result = await client.Membership.CreatePolicyAsync(new CreatePolicy
{
    PolicyName = "articles-editor",
    Description = "Read and write access to the articles collection.",
    PolicyDocumentJson = "{\"allow\":[\"articles:read\",\"articles:write\"]}",
});

Python

from norbix_python import NorbixHub

norbix = NorbixHub()

result = norbix.membership.create_policy(
    policyName="articles-editor",
    description="Read and write access to the articles collection.",
    policyDocumentJson="{\"allow\":[\"articles:read\",\"articles:write\"]}",
)

Go

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

var result map[string]any
err := c.Hub.Membership.CreatePolicy(ctx, map[string]any{
	"policyName": "articles-editor",
	"description": "Read and write access to the articles collection.",
	"policyDocumentJson": "{\"allow\":[\"articles:read\",\"articles:write\"]}",
}, &result)

Dart / Flutter

import 'package:norbix/norbix_hub.dart';

final hub = NorbixHub();

final result = await hub.membership.createPolicy(body: {
  'policyName': 'articles-editor',
  'description': 'Read and write access to the articles collection.',
  'policyDocumentJson': '{"allow":["articles:read","articles:write"]}',
});

Swift

import NorbixSwift

let client = Norbix()

let result = try await client.hub.membership.createPolicy([
    "policyName": "articles-editor",
    "description": "Read and write access to the articles collection.",
    "policyDocumentJson": "{\"allow\":[\"articles:read\",\"articles:write\"]}",
])

Kotlin

import dev.norbix.sdk.hub.NorbixHub

val hub = NorbixHub()

val result = hub.membership.createPolicy(mapOf(
    "policyName" to "articles-editor",
    "description" to "Read and write access to the articles collection.",
    "policyDocumentJson" to "{\"allow\":[\"articles:read\",\"articles:write\"]}",
))

CLI

norbix hub membership policy create --policyName articles-editor --description 'Read and write access to the articles collection.' --policyDocumentJson '{"allow":["articles:read","articles:write"]}'

In the dashboard

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

API reference

Full request and response for this endpoint: Create Policy.