> ## Documentation Index
> Fetch the complete documentation index at: https://fly-io-actions-update-machines-openapi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Apps

> List all apps with the ability to filter by organization slug.




## OpenAPI

````yaml /api/machines/openapi.json get /v1/apps
openapi: 3.0.1
info:
  title: Machines API
  description: >-
    This site hosts documentation generated from the Fly.io Machines API OpenAPI
    specification. Visit our complete [Machines API
    docs](https://fly.io/docs/machines/api/) for how to get started, more
    information about each endpoint, parameter descriptions, and examples.
  contact: {}
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: '1.0'
servers:
  - url: https://api.machines.dev
security:
  - FlyBearerAuth: []
tags:
  - name: Apps
    description: >-
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/apps-resource/) for details about
      using the Apps resource.
  - name: Machines
    description: >-
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/machines-resource/) for details
      about using the Machines resource.
  - name: TLS Certificates
    description: >
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/certificates-resource/) for details
      about using the TLS Certificates resource.
  - name: Volumes
    description: >-
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/volumes-resource/) for details
      about using the Volumes resource.
  - name: Postgres Clusters
    description: >-
      Create and manage Postgres clusters, including databases, users,
      extensions, backups, and app attachments.
externalDocs:
  url: https://fly.io/docs/machines/working-with-machines/
paths:
  /v1/apps:
    get:
      tags:
        - Apps
      summary: List Apps
      description: |
        List all apps with the ability to filter by organization slug.
      operationId: Apps_list
      parameters:
        - name: org_slug
          in: query
          description: The org slug, or 'personal', to filter apps
          required: true
          schema:
            type: string
        - name: app_role
          in: query
          description: Filter apps by role
          schema:
            type: string
        - name: limit
          in: query
          description: >-
            The number of apps to fetch (must be between 1 and 5000). Providing
            a limit enables pagination. Without it, all apps are returned in one
            response.
          schema:
            type: integer
        - name: cursor
          in: query
          description: >-
            Value of next_cursor from the previous page. Requires limit. Later
            pages only include apps that existed when the first page was
            requested. Apps created in the seconds before the first page was
            requested may be missing. Cursors expire 30 minutes after the first
            page was requested.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAppsResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ListAppsResponse:
      type: object
      properties:
        apps:
          type: array
          items:
            $ref: '#/components/schemas/App'
        next_cursor:
          type: string
          description: >-
            Pagination cursor for the next page. Absent when no more apps
            remain.

            Cursors expire 30 minutes after the first page was requested.
        total_apps:
          type: integer
          description: >-
            The number of apps matching the request, across all pages. When

            paginating, it is counted once when the first page is requested and
            not

            updated afterwards, so it may differ slightly from the number of
            apps

            returned: it excludes apps created later and includes apps deleted
            while

            paginating. Apps created in the seconds before the first page may
            also be

            counted but missing from the pages.
    ErrorResponse:
      type: object
      properties:
        details:
          type: object
          description: Deprecated
        error:
          type: string
        status:
          $ref: '#/components/schemas/main.statusCode'
    App:
      type: object
      properties:
        id:
          type: string
        internal_numeric_id:
          type: integer
        machine_count:
          type: integer
        name:
          type: string
        network:
          type: string
        network_cidr:
          type: string
        organization:
          $ref: '#/components/schemas/AppOrganizationInfo'
        status:
          type: string
        volume_count:
          type: integer
    main.statusCode:
      type: string
      enum:
        - unknown
        - insufficient_capacity
        - volume_placement_capacity
        - name_taken
      x-enum-varnames:
        - unknown
        - capacityErr
        - volumePlacementCapacityErr
        - nameTakenErr
    AppOrganizationInfo:
      type: object
      properties:
        internal_numeric_id:
          type: integer
        name:
          type: string
        slug:
          type: string
  securitySchemes:
    FlyBearerAuth:
      type: apiKey
      description: >-
        A Fly API token with access to the requested organization or resource.
        Send it as `Authorization: Bearer <Fly API token>`.
      name: Authorization
      in: header

````