> ## 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 organization roles with their permissions

> List every organization role together with the permissions it grants.



## OpenAPI

````yaml https://api.ionworks.com/openapi.json get /roles/organization
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://api.ionworks.com
    description: Production
security: []
paths:
  /roles/organization:
    get:
      tags:
        - roles
      summary: List all organization roles with their permissions
      description: List every organization role together with the permissions it grants.
      operationId: list_organization_roles_roles_organization_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/OrganizationRoleWithPermissions'
                type: array
                title: Response List Organization Roles Roles Organization Get
components:
  schemas:
    OrganizationRoleWithPermissions:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
        permissions:
          items:
            $ref: '#/components/schemas/Permission'
          type: array
          title: Permissions
      type: object
      required:
        - id
        - name
      title: OrganizationRoleWithPermissions
      description: >-
        Organization role with its permissions flattened into a list.


        Read model for the admin Roles page. Unlike :class:`OrganizationRole`,
        the

        nested ``organization_role_permissions`` join rows are flattened to a
        plain

        ``permissions`` list so the frontend does not have to unwrap the join
        shape.
    Permission:
      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
      type: object
      required:
        - action
      title: Permission

````