> ## 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.

# Create folder

> Create a folder.

Creates a folder in a space. The `creatorEmail` must belong to an active workspace member who is not a guest, and who gets full access to the folder.


## OpenAPI

````yaml POST /v1/folders
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:
    post:
      description: Create a folder.
      operationId: postV1Folders
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                creatorEmail:
                  type: string
                  format: email
                  description: >-
                    Email of the workspace member recorded as the folder
                    creator, who gets full access to it.
                description:
                  type: string
                  description: Folder description, in markdown.
                iconId:
                  type: string
                  description: >-
                    Emoji shortcode used as the folder icon, for example
                    `:file_folder:`.
                memberPermission:
                  type: string
                  enum:
                    - NoAccess
                    - CanView
                    - CanComment
                    - FullAccess
                  description: >-
                    Permission of workspace members on the folder. `FullAccess`
                    makes it a shared folder; `NoAccess` makes it private to the
                    creator and the users they invite.
                publicPermission:
                  type: string
                  enum:
                    - NoAccess
                    - CanComment
                  default: NoAccess
                  description: >-
                    Public link of the folder. `NoAccess` turns it off.
                    `CanComment` lets anyone with the link open the folder
                    without signing up, and requires public links to be enabled
                    on the workspace.
                searchable:
                  type: boolean
                  default: true
                  description: >-
                    Whether workspace members can find the recordings of the
                    folder in search results. Ignored when `memberPermission` is
                    `NoAccess`.
                spaceId:
                  type: string
                  description: >-
                    Identifier of the space (sidebar group of folders) the
                    folder belongs to, as the `spaceId` of an existing folder.
                title:
                  type: string
                  minLength: 1
                  description: Folder title.
              required:
                - creatorEmail
                - memberPermission
                - spaceId
                - title
      responses:
        '200':
          description: Folder was successfully created
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/ApiFolder'
                required:
                  - result
        '400':
          description: >-
            The request is not valid. For instance the creator email does not
            correspond to an active workspace member.
        '403':
          description: >-
            The folder cannot be created. For instance the creator is a guest,
            the workspace plan does not allow creating folders, the space does
            not exist, or `publicPermission` is not `NoAccess` while public
            links are disabled on the workspace.
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
        searchable:
          type: boolean
          description: >-
            Whether workspace members can find the recordings of the folder in
            search results. Always `false` when `memberPermission` is
            `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
        - searchable
        - spaceId
        - title
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Claap-Key

````