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

# Get Folder Tree

> Returns the folder with its full nested subtree, for mirroring your
catalog structure in one call instead of walking `parent_id` level by
level.




## OpenAPI

````yaml GET /folders/{id}/tree
openapi: 3.1.0
info:
  title: Edpire API
  description: >
    Edpire is a headless assessment engine. This API lets you manage
    assessments,

    submit answers for grading, retrieve results, organise them into folders,
    and configure

    webhooks for real-time notifications.


    All responses use a consistent envelope: `{ data, error, meta }`.
  version: 1.0.0
  contact:
    name: Edpire Support
    url: https://edpire.com
  license:
    name: Proprietary
servers:
  - url: https://edpire.com/api/v1
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Assessments
    description: Create, list, update, publish, and grade assessments
  - name: Submissions
    description: Retrieve submission details
  - name: Learners
    description: Query learner results
  - name: Webhooks
    description: Register and manage webhook endpoints
  - name: Embed
    description: Mint tokens and load assessments for browser-side rendering
  - name: Folders
    description: Nestable structure for filing assessments
  - name: Authoring
    description: Hand an author into the Edpire builder from your own admin
paths:
  /folders/{id}/tree:
    get:
      tags:
        - Folders
      summary: Get a folder and its descendants
      description: |
        Returns the folder with its full nested subtree, for mirroring your
        catalog structure in one call instead of walking `parent_id` level by
        level.
      operationId: getFolderTree
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The subtree rooted at this folder
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/FolderTreeNode'
                  error:
                    type: 'null'
                  meta:
                    type: 'null'
        '404':
          description: Folder not found in this organization
components:
  schemas:
    FolderTreeNode:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        slug:
          type: string
        parent_folder_id:
          type: string
          format: uuid
          nullable: true
        children:
          type: array
          items:
            $ref: '#/components/schemas/FolderTreeNode'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >
        API key starting with `edp_live_`. Pass via `Authorization: Bearer
        edp_live_xxx`.


        Scopes: `read:assessments`, `write:assessments`, `read:results`,
        `write:submissions`.

````