Permissions
Create new permission
Creates a new permission that represents a specific action users can perform within the environment. Use this endpoint to define granular access controls for your RBAC system. You can provide a unique permission name following the format 'action:resource' (for example, 'read:documents', 'write:users') and an optional description explaining the permission's purpose. The permission name must be unique across the environment and follows alphanumeric naming conventions with colons and underscores. Returns the created permission object including system-generated ID and timestamps.
post/api/v1/permissions
Request body
Example request
{
"description": "Allows user to read documents from the system",
"name": "read:documents"
}Response
Permission created successfully. Returns the complete permission object with system-generated ID, name, description, and timestamps.
Example response
{
"permission": {
"is_scalekit_permission": true
}
}