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

# Create Folder

> Create a new folder for organizing entities



## OpenAPI

````yaml /public-apis/openapi/folders.json post /v1/folders
openapi: 3.0.0
info:
  version: 1.0.0
  contact:
    name: Maxim Engineering
    email: eng@getmaxim.ai
  title: Maxim SDK API - folders
  description: API documentation for Maxim SDK folders endpoints
servers:
  - url: https://api.getmaxim.ai
security: []
paths:
  /v1/folders:
    post:
      tags:
        - Folder
      summary: Create Folder
      description: Create a new folder for organizing entities
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                workspaceId:
                  type: string
                  minLength: 1
                  description: Unique identifier for the workspace
                name:
                  type: string
                  minLength: 1
                  description: Name of the folder
                entityType:
                  type: string
                  enum:
                    - WORKFLOW
                    - PROMPT_CHAIN
                    - DATASET
                    - PROMPT
                    - CONTEXT_SOURCE
                    - PROMPT_COMPARISONS
                    - LOG_REPOSITORY
                    - PROMPT_TOOL
                    - EVALUATOR
                  description: Type of entity for the folder
                parentId:
                  type: string
                  nullable: true
                  description: ID of the parent folder, if any
                config:
                  nullable: true
                  description: >-
                    Additional configuration for the folder. Can be any
                    key-value pair.
              required:
                - workspaceId
                - name
                - entityType
      responses:
        '201':
          description: Folder created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Folder'
                required:
                  - data
        '400':
          description: Invalid request parameters
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Folder:
      type: object
      properties:
        id:
          type: string
        workspaceId:
          type: string
        name:
          type: string
        entityType:
          type: string
          enum:
            - WORKFLOW
            - WORKFLOW_SIMULATION
            - PROMPT_CHAIN
            - DATASET
            - DATASET_SPLIT
            - PROMPT
            - DATASOURCE
            - PROMPT_EXPERIMENT
            - LOG_REPOSITORY
            - PROMPT_TOOL
            - EVALUATOR
            - SDK
            - TEST_RUN
            - RUN_REPORT
        parentId:
          type: string
          nullable: true
        config:
          nullable: true
        createdAt:
          type: string
        updatedAt:
          type: string
        type:
          type: string
          enum:
            - FOLDER
      required:
        - id
        - workspaceId
        - name
        - entityType
        - parentId
        - createdAt
        - updatedAt
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-maxim-api-key
      description: API key for authentication

````