{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-folder-update-request-schema.json",
  "title": "FolderUpdateRequest",
  "description": "Rename a folder, or move it under a different parent.\n\nTwo fields, and the omissions are each recorded elsewhere at their own\ndefinition site. `color` and `pinned` are UI chrome and unpublished on the\nread model too. `matterId` is not repatriable: moving a matter folder to a\ndifferent matter is a reorganization of the customer's work that has no\nheadless meaning, and the web app itself guards it with three separate\nconsistency checks rather than treating it as a field.\n\nA cycle (`parentId` naming the folder itself or one of its descendants) is\nrefused by the `folders_prevent_cycle` trigger. This API does not\nreimplement the web app's 100-step ancestor walk: a second Python copy would\nbe weaker and would still lose a race with a concurrent move.",
  "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/FolderUpdateRequest",
  "properties": {
    "name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Name",
      "description": "New display name. Trimmed; whitespace alone is refused. Cannot be set to null."
    },
    "parentId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Parentid",
      "description": "`fld_` identifier of the folder to move this one under. Must belong to your organization. Send null to move it to the root. A cycle is refused by the database."
    }
  },
  "additionalProperties": false,
  "type": "object"
}