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

# List Folders

> List scenario folders for a project



## OpenAPI

````yaml get /test_framework/v1/scenarios/folders/
openapi: 3.1.0
info:
  title: Cekura API
  version: v1
  description: >-
    Complete API documentation for the Cekura platform. This API provides
    endpoints for testing, observing, and evaluating AI voice agents — including
    managing agents, running evaluators, defining metrics, and analyzing call
    quality.
servers:
  - url: https://api.cekura.ai
security: []
paths:
  /test_framework/v1/scenarios/folders/:
    get:
      tags:
        - test_framework
      description: List scenario folders for a project
      operationId: scenarios-folders-list
      parameters:
        - name: page
          required: false
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - in: query
          name: project_id
          schema:
            type: integer
          description: Project ID to list folders for
          required: true
        - in: query
          name: parent_path
          schema:
            type: string
          description: >-
            Parent folder path to get direct children only. Example:
            "Sales.Inbound"
        - in: query
          name: search
          schema:
            type: string
          description: Search folders by name (case-insensitive)
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedScenarioFolderList'
          description: ''
      security:
        - api_key: []
components:
  schemas:
    PaginatedScenarioFolderList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: https://api.cekura.ai/example/v1/example-external/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: https://api.cekura.ai/example/v1/example-external/?page=3
        results:
          type: array
          items:
            $ref: '#/components/schemas/ScenarioFolder'
    ScenarioFolder:
      type: object
      properties:
        name:
          type: string
          maxLength: 300
        path:
          type: string
          readOnly: true
          description: Human-readable path with case preservation
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - name
  securitySchemes:
    api_key:
      type: apiKey
      name: X-CEKURA-API-KEY
      in: header
      description: >-
        API Key Authentication. It should be included in the header of each
        request.

````