# Create a permission

Creates a new named permission that can be assigned to roles.

Request:
id            - Unique identifier for the permission (caller-supplied, not auto-generated).
name          - Human-readable display name.
description   - Optional description of what this permission grants.

Response:
permission    - The created PermissionItem.

Endpoint: POST /api/v1/permission/create-permission
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `id` (string)
    Rule data fields

  - `name` (string)
    Rule data fields

  - `description` (string)
    Rule data fields

## Response 200 fields (application/json):

  - `permission` (object)

  - `permission.id` (string)
    Rule data fields

  - `permission.name` (string)
    Rule data fields

  - `permission.description` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)