{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-folder-create-request-schema.json",
  "title": "FolderCreateRequest",
  "description": "Everything a caller may set when creating a folder.\n\nBoth references are verified against the calling installation's organization\nbefore the row is written. Cycles are refused by the `folders_prevent_cycle`\ntrigger, which is a database-level guarantee this API does not duplicate.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vaquill-ai-folders-api-openapi.yml#/components/schemas/FolderCreateRequest",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "title": "Name",
      "description": "Display name for the folder. Trimmed; whitespace alone is refused."
    },
    "parentId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Parentid",
      "description": "`fld_` identifier of the folder to nest this one under. Must belong to your organization. A cycle is refused by the database."
    },
    "matterId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Matterid",
      "description": "`mat_` identifier to scope this folder to one matter. Must belong to your organization. Omit for a workspace-level folder shared across drafts and chats."
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "name"
  ]
}