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

# List Files



## OpenAPI

````yaml actionkit/openapi.json POST /projects/{project_id}/tools/#BOX_LIST_FILES_V2
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#BOX_LIST_FILES_V2:
    post:
      summary: List Files
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: BOX_LIST_FILES_V2
                parameters:
                  type: object
                  properties:
                    folderId:
                      type: string
                      description: >-
                        Folder ID : The unique identifier that represents a
                        folder. (example: "0")
                    filterFormula:
                      type: array
                      description: List of filter conditions to filter by (joined by AND)
                      items:
                        type: object
                        properties:
                          field:
                            type: string
                            enum:
                              - direction
                              - sort
                          operator:
                            type: string
                            enum:
                              - $stringExactlyMatches
                              - $booleanFalse
                              - $booleanTrue
                              - $numberEquals
                          value:
                            type: string
                            description: Value to compare against
                        required:
                          - field
                          - operator
                          - value
                    paginationParameters:
                      type: object
                      description: Pagination Parameters
                      properties:
                        pageCursor:
                          type: string
                          description: >-
                            The cursor to use for requesting additional results.
                            Use if you received a previous response with a page
                            cursor and require more results.
                        limit:
                          type: number
                          description: >-
                            The maximum number of records to load in one page of
                            results. Since Box returns mixed files and folders,
                            filtered results may contain fewer records than the
                            limit (or none) even when nextPageCursor is present.
                            Continue paginating until nextPageCursor is null.
                  required:
                    - folderId
                  x-integration: box
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````