const { result, error } = await unkey.permissions.createPermission({
  name: "record.write",
  description:
    "record.write can create new dns records for our domains.",
});

if (error) {
  // handle potential network or bad request error
  // a link to our docs will be in the `error.docs` field
  console.error(error.message);
  return;
}

console.log(result);
{
  "result": {
      "permissionId": "perm_123"
    }
}
const { result, error } = await unkey.permissions.createPermission({
  name: "record.write",
  description:
    "record.write can create new dns records for our domains.",
});

if (error) {
  // handle potential network or bad request error
  // a link to our docs will be in the `error.docs` field
  console.error(error.message);
  return;
}

console.log(result);
{
  "result": {
      "permissionId": "perm_123"
    }
}

To use this function, your root key must have the rbac.*.create_permission permission.

​
Request

​
name
string
required

The unique name of your permission.

Required string length: 3 - 256

Example: "record.write"

​
description
string

Explain what this permission does. This is just for your team, your users will not see this.

Required string length: 3 - 256

Example:"record.write can create new dns records for our domains."

​
Response

​
permissionId
string
required

The id of the permission. This is used internally

Example: "perm_123"