Organization Permissions

Create a new organization permission

Changed on

Creates a new organization permission for the given instance.

post/organization_permissions

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/organization_permissions
  • Auth: HTTP bearer

Request body

namestring required

The name of the permission.

keystring required

The key of the permission. Must have the format "org:feature:action" where feature and action are segments consisting of lowercase letters, digits, or underscores, for example "org:billing:manage" or "org:team:read". Cannot begin with "org:sys_" as that prefix is reserved for system permissions.

descriptionstring

A description of the permission.

Response

Success

object'permission' required
idstring required
namestring required
keystring required
descriptionstring required
typestring required
created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.

Changes