List Folders

Current

List all accessible folders with pagination, sorted alphabetically. Includes folder hierarchy via parent_folder_id.

OpenAPI

openapi: 3.1.0
info:
  title: Granola API
  version: 1.0.0
  description: API for accessing meeting data from Granola
servers:
  - url: https://public-api.granola.ai
    description: Production
security: []
paths:
  /v1/folders:
    get:
      summary: List folders
      parameters:
        - schema:
            type: string
            description: The cursor to continue from
            example: eyJjcmVkZW50aWFsfQ==
          required: false
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 30
            default: 10
            description: Maximum number of folders to return per page
            example: 10
          required: false
          name: page_size
          in: query
      responses:
        '200':
          description: List of folders
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFoldersOutput'
        '400':
          description: Bad request
        '401':
          description: Unauthorized - Invalid API key
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ListFoldersOutput:
      type: object
      properties:
        folders:
          type: array
          items:
            $ref: '#/components/schemas/Folder'
        hasMore:
          type: boolean
          description: Whether there are more folders to fetch
          example: true
        cursor:
          type:
            - string
            - 'null'
          description: The cursor to continue from
          example: eyJjcmVkZW50aWFsfQ==
      required:
        - folders
        - hasMore
        - cursor
    Folder:
      type: object
      properties:
        id:
          type: string
          pattern: ^fol_[a-zA-Z0-9]{14}$
          description: The ID of the folder
          example: fol_4y6LduVdwSKC27
        object:
          type: string
          enum:
            - folder
        name:
          type: string
          description: The name of the folder
          example: Top secret recipes
        parent_folder_id:
          type:
            - string
            - 'null'
          pattern: ^fol_[a-zA-Z0-9]{14}$
          description: The ID of the parent folder, or null if the folder is top-level.
          example: fol_a74g2hvl98iUHG
      required:
        - id
        - object
        - name
        - parent_folder_id
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: apiKey