tags:
  - Permissions
summary: Cria uma nova permissão
parameters:
  - name: body
    in: body
    required: true
    schema:
      type: object
      required:
        - name
      properties:
        name:
          type: string
          description: "Nome da permissão. (Obrigatório)"
          example: "read_articles"
        description:
          type: string
          description: "Descrição adicional da permissão (opcional)."
          example: "Permissão para ler artigos"

responses:
  201:
    description: Permissão criada com sucesso.
    schema:
      type: object
      properties:
        message:
          type: string
          example: "Permissão criada com sucesso."

  400:
    description: Permissão já existe no sistema.
    schema:
      type: object
      properties:
        error:
          type: string
          example: "Permissão já existe."