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

# Get folder details

> Retrieve a folder.

Retrieves a single folder of the workspace. API keys without access to private recordings cannot access folders whose `memberPermission` is `NoAccess`: they are reported as not found.


## OpenAPI

````yaml GET /v1/folders/{folderId}
openapi: 3.1.0
info:
  title: Claap API
  description: Development documentation
  version: 0.0.0
servers:
  - url: https://api.claap.io/
security:
  - ApiKey: []
paths:
  /v1/folders/{folderId}:
    get:
      description: Retrieve a folder.
      operationId: getV1FoldersByFolderId
      parameters:
        - in: path
          name: folderId
          schema:
            type: string
            description: Folder identifier
          required: true
      responses:
        '200':
          description: Folder was successfully retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/ApiFolder'
                required:
                  - result
        '404':
          description: >-
            Folder was not found. Note that API keys without access to private
            recordings cannot access folders whose `memberPermission` is
            `NoAccess`, which are reported as not found.
components:
  schemas:
    ApiFolder:
      type: object
      properties:
        description:
          type: string
          description: Folder description, in markdown.
        folderId:
          type: string
          description: >-
            Folder identifier. It is the `channel.id` of recordings and the
            `channelId` of the recording endpoints.
        iconId:
          type: string
          description: Emoji shortcode used as the folder icon, empty when it has none.
        memberPermission:
          type: string
          enum:
            - NoAccess
            - CanView
            - CanComment
            - FullAccess
          description: >-
            Permission of workspace members on the folder. `NoAccess` means only
            invited users and user groups can access it.
          example: FullAccess
        publicPermission:
          type: string
          enum:
            - NoAccess
            - CanView
            - CanComment
          description: >-
            Public link of the folder. `NoAccess` means it is off. `CanComment`
            means anyone with the link can open the folder without signing up.
            `CanView` can still be returned for older folders, but can no longer
            be set.
          example: NoAccess
        spaceId:
          type: string
          description: >-
            Identifier of the space (sidebar group of folders) the folder
            belongs to.
        title:
          type: string
          description: Folder title.
      required:
        - description
        - folderId
        - iconId
        - memberPermission
        - publicPermission
        - spaceId
        - title
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Claap-Key

````