> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List all permissions with the roles that grant them

> List every permission together with the org/project roles referencing it.



## OpenAPI

````yaml https://api.ionworks.com/openapi.json get /permissions
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://api.ionworks.com
    description: Production
security: []
paths:
  /permissions:
    get:
      tags:
        - permissions
      summary: List all permissions with the roles that grant them
      description: >-
        List every permission together with the org/project roles referencing
        it.
      operationId: list_permissions_permissions_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/PermissionWithRoles'
                type: array
                title: Response List Permissions Permissions Get
components:
  schemas:
    PermissionWithRoles:
      properties:
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        action:
          type: string
          title: Action
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
        organization_roles:
          items:
            $ref: '#/components/schemas/RoleRef'
          type: array
          title: Organization Roles
        project_roles:
          items:
            $ref: '#/components/schemas/RoleRef'
          type: array
          title: Project Roles
      type: object
      required:
        - action
      title: PermissionWithRoles
      description: |-
        A permission together with the roles that grant it.

        Read model for the admin Permissions page: each permission alongside the
        organization and project roles that reference it.
    RoleRef:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
      type: object
      required:
        - id
        - name
      title: RoleRef
      description: Minimal role reference (id + name) attached to a permission.

````