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

# Get Template Folders

> Returns all template folders in the given workspace.



## OpenAPI

````yaml GET /api/v1/task/workspaces/{workspaceId}/folders
openapi: 3.1.0
info:
  title: Xenia Team API - Get Template Folders
  version: 1.0.0
  description: >-
    Fetches all template folders within a specific workspace, including
    metadata, folder hierarchy, and creator details.
servers:
  - url: https://api.xenia.team
security: []
paths:
  /api/v1/task/workspaces/{workspaceId}/folders:
    get:
      tags:
        - Templates
      summary: Get Template Folders
      description: Returns all template folders in the given workspace.
      parameters:
        - name: workspaceId
          in: path
          required: true
          description: UUID of the workspace
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: List of template folders returned successfully.
          content:
            application/json:
              example:
                data:
                  - id: 69f7bdfd-d64b-4f70-a73e-b0a77ba8ff8e
                    workspaceId: cb363f7e-c52a-4478-911d-f6a6f791090e
                    title: Calculation step with followups
                    meta: {}
                    CreatedBy: e25dd448-7ae7-4588-8767-7e1a316547e5
                    UpdatedBy: e25dd448-7ae7-4588-8767-7e1a316547e5
                    archivedAt: null
                    ParentId: bd9c7fa3-c74f-4bae-a59f-779ff4f688d5
                    createdAt: '2025-06-19T11:45:44.365Z'
                    updatedAt: '2025-06-19T11:45:44.365Z'
                    deletedAt: null
                    Creator:
                      fullName: Full User (China)
                      id: e25dd448-7ae7-4588-8767-7e1a316547e5
                      firstName: Full User
                      lastName: (China)
                    path:
                      - id: bd9c7fa3-c74f-4bae-a59f-779ff4f688d5
                        title: Moiz
                        parentId: null
                    itemsCount: 1
                  - id: 183e72ce-03c5-47a5-b391-9a132ccc2b49
                    workspaceId: cb363f7e-c52a-4478-911d-f6a6f791090e
                    title: May 23
                    meta: {}
                    CreatedBy: dfea8b8a-5b22-4668-b68d-dc641eb3a101
                    UpdatedBy: dfea8b8a-5b22-4668-b68d-dc641eb3a101
                    archivedAt: null
                    ParentId: null
                    createdAt: '2025-05-23T07:50:29.278Z'
                    updatedAt: '2025-05-23T07:50:29.278Z'
                    deletedAt: null
                    Creator:
                      fullName: Admin (Karachi)
                      id: dfea8b8a-5b22-4668-b68d-dc641eb3a101
                      firstName: Admin
                      lastName: (Karachi)
                    path: []
                    itemsCount: 10
                meta: {}
        '400':
          description: Bad Request - Invalid workspace ID format.
        '401':
          description: Unauthorized - Missing or invalid authentication.
        '403':
          description: Forbidden - Insufficient permissions to access folders.
        '404':
          description: Not Found - Workspace does not exist.
        '500':
          description: Internal Server Error.
      security:
        - clientKey: []
          clientSecret: []
components:
  securitySchemes:
    clientKey:
      type: apiKey
      in: header
      name: client-key
    clientSecret:
      type: apiKey
      in: header
      name: client-secret

````