Tabellenlayout ändern

{
  "operationId": "put_v2_layout_id_table",
  "summary": "Tabellenlayout ändern",
  "description": "Ändert Name, Leerzeilen, Zeilenmaße oder Spalten des Tabellenlayouts. Bei columns wird die vollständige neue Spaltenliste übergeben und strikt anhand der Spaltenstruktur validiert. Ein nicht leeres data mit einem beschreibbaren Feld ist erforderlich.",
  "tags": [
    "layout"
  ],
  "security": [
    {
      "bearerAuth": [],
      "accountContext": []
    },
    {
      "sessionCookie": [],
      "accountContext": []
    }
  ],
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "Öffentliche v2-ID des ausgewählten Objekts.",
      "schema": {
        "type": "string",
        "pattern": "^layouttable_[a-f0-9]{12}_-?[0-9]+$",
        "description": "Öffentliche v2-ID aus diesem Konto; keine Datenbank-ID. Beispiel ist synthetisch.",
        "examples": [
          "layouttable_012345abcdef_123456"
        ]
      }
    },
    {
      "name": "X-Edoobox-If-Revision",
      "in": "header",
      "required": false,
      "schema": {
        "type": "string",
        "pattern": "^[a-f0-9]{32}$",
        "examples": [
          "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      },
      "description": "Optional account mutation revision from a preceding authenticated auth-context snapshot. The dispatcher compares it while holding the account lock; mismatch409 requires a new review."
    }
  ],
  "responses": {
    "200": {
      "description": "data.id und update melden, ob das ausgewählte Layout geändert wurde.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "error": {
                "type": [
                  "boolean",
                  "string"
                ]
              },
              "error_code": {
                "type": "string"
              },
              "data": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^layouttable_[a-f0-9]{12}_-?[0-9]+$",
                    "description": "Öffentliche v2-ID aus diesem Konto; keine Datenbank-ID. Beispiel ist synthetisch.",
                    "examples": [
                      "layouttable_012345abcdef_123456"
                    ]
                  },
                  "update": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": true,
                "required": [
                  "id",
                  "update"
                ]
              },
              "type": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "examples": {
            "updated": {
              "value": {
                "error": false,
                "data": {
                  "update": true,
                  "id": "layouttable_012345abcdef_123456"
                }
              }
            },
            "reviewed": {
              "value": {
                "error": false,
                "data": {
                  "id": "layouttable_012345abcdef_123456",
                  "update": true
                }
              }
            }
          }
        }
      },
      "headers": {
        "X-Edoobox-Revision": {
          "schema": {
            "type": "string",
            "pattern": "^[a-f0-9]{32}$"
          },
          "description": "Rotated account revision supplied for the next action in one reviewed sequence."
        }
      }
    },
    "400": {
      "description": "Invalid request.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED40006"
          }
        }
      }
    },
    "401": {
      "description": "Missing/expired token, missing account context, account paused or model-specific authorization failure.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED40103"
          }
        }
      }
    },
    "402": {
      "description": "Missing/invalid action data or subscription/operation restriction.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED80100"
          }
        }
      }
    },
    "403": {
      "description": "Permission denied. Browser CORS rejection may have an empty body.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED40340"
          }
        }
      }
    },
    "404": {
      "description": "Unknown resource/action or unsupported method.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED80019"
          }
        }
      }
    },
    "409": {
      "description": "The account changed after the reviewed read. No domain operation is dispatched; obtain fresh state and review again.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true
          },
          "example": {
            "error": "ED40901",
            "error_code": "mutation_revision_conflict"
          }
        }
      }
    },
    "422": {
      "description": "Validation failed.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED80020"
          }
        }
      }
    },
    "429": {
      "description": "Request/login rate limit exceeded. Honor Retry-After when supplied; legacy rate-limit paths may omit it. Retry only proven reads within a bounded deadline; a mutation is never automatically replayed after an ambiguous response.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED42902"
          }
        }
      },
      "headers": {
        "Retry-After": {
          "description": "Optional server delay in whole seconds or an HTTP date. Absence is not permission for an immediate retry.",
          "schema": {
            "type": "string",
            "examples": [
              "30"
            ]
          }
        }
      }
    },
    "502": {
      "description": "Server-side operation failed.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED50201"
          }
        }
      }
    },
    "503": {
      "description": "The account mutation lock or revision store is unavailable. No unprotected fallback is executed.",
      "headers": {
        "Retry-After": {
          "schema": {
            "type": "integer",
            "const": 1
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true
          },
          "example": {
            "error": "ED50301",
            "error_code": "mutation_revision_busy"
          }
        }
      }
    }
  },
  "x-edoobox-mutates-state": true,
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "data"
          ],
          "properties": {
            "data": {
              "type": "object",
              "properties": {
                "id": false,
                "status": {
                  "x-edoobox-schemaStatus": "source-inferred",
                  "x-edoobox-sourceLine": 229,
                  "x-edoobox-canonicalType": "boolean",
                  "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.",
                  "examples": [
                    false
                  ]
                },
                "name": {
                  "x-edoobox-canonicalType": "string",
                  "x-edoobox-maxStoredLength": 150,
                  "x-edoobox-normalization": "The aP getter trims text, replaces newlines and limits the legacy escaped storage representation to maxStoredLength UTF-8 characters without splitting escape pairs; aQ decodes the stored representation. Non-string input becomes empty text. This getter limit is normalization, not a rejecting input maxLength or proof of a custom action hook or database column capacity.",
                  "examples": [
                    "Example"
                  ],
                  "x-edoobox-requiredOnCreate": true,
                  "x-edoobox-sourceLine": 238
                },
                "empty_rows_top": {
                  "x-edoobox-requiredOnCreate": true,
                  "x-edoobox-schemaStatus": "source-inferred",
                  "x-edoobox-sourceLine": 251,
                  "x-edoobox-canonicalType": "integer",
                  "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.",
                  "examples": [
                    1
                  ]
                },
                "empty_rows_bottom": {
                  "x-edoobox-requiredOnCreate": true,
                  "x-edoobox-schemaStatus": "source-inferred",
                  "x-edoobox-sourceLine": 264,
                  "x-edoobox-canonicalType": "integer",
                  "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.",
                  "examples": [
                    1
                  ]
                },
                "row_minheight_header": {
                  "x-edoobox-requiredOnCreate": true,
                  "x-edoobox-schemaStatus": "source-inferred",
                  "x-edoobox-sourceLine": 277,
                  "x-edoobox-canonicalType": "integer",
                  "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.",
                  "examples": [
                    1
                  ]
                },
                "row_minheight_body": {
                  "x-edoobox-requiredOnCreate": true,
                  "x-edoobox-schemaStatus": "source-inferred",
                  "x-edoobox-sourceLine": 290,
                  "x-edoobox-canonicalType": "integer",
                  "x-edoobox-normalization": "PHP coercion/normalization is applied by the Structure getter; its return type is not a rejecting wire-input type restriction.",
                  "examples": [
                    1
                  ]
                },
                "columns": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "default": ""
                          },
                          "name": {
                            "type": "string"
                          },
                          "header_display_names": {
                            "type": "string"
                          },
                          "header_text_vertical": {
                            "type": "boolean",
                            "default": false
                          },
                          "header_display_css_class": {
                            "type": "string",
                            "default": ""
                          },
                          "amount_of_entries": {
                            "type": "integer",
                            "default": 1
                          },
                          "type": {
                            "x-edoobox-knownInputs": [
                              "dates_all",
                              "dates_next",
                              "participation",
                              "custom"
                            ],
                            "x-edoobox-normalization": "Reviewed hook uses PHP loose in_array; these are canonical values, not an exhaustive JSON input enum.",
                            "examples": [
                              "dates_all"
                            ]
                          },
                          "type_row_data": {
                            "type": "string"
                          },
                          "row_text_vertical": {
                            "type": "boolean",
                            "default": false
                          },
                          "type_row_css_class": {
                            "type": "string",
                            "default": ""
                          },
                          "width": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "name",
                          "header_display_names",
                          "type",
                          "type_row_data",
                          "width"
                        ],
                        "additionalProperties": true
                      }
                    },
                    {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "default": ""
                          },
                          "name": {
                            "type": "string"
                          },
                          "header_display_names": {
                            "type": "string"
                          },
                          "header_text_vertical": {
                            "type": "boolean",
                            "default": false
                          },
                          "header_display_css_class": {
                            "type": "string",
                            "default": ""
                          },
                          "amount_of_entries": {
                            "type": "integer",
                            "default": 1
                          },
                          "type": {
                            "x-edoobox-knownInputs": [
                              "dates_all",
                              "dates_next",
                              "participation",
                              "custom"
                            ],
                            "x-edoobox-normalization": "Reviewed hook uses PHP loose in_array; these are canonical values, not an exhaustive JSON input enum.",
                            "examples": [
                              "dates_all"
                            ]
                          },
                          "type_row_data": {
                            "type": "string"
                          },
                          "row_text_vertical": {
                            "type": "boolean",
                            "default": false
                          },
                          "type_row_css_class": {
                            "type": "string",
                            "default": ""
                          },
                          "width": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "name",
                          "header_display_names",
                          "type",
                          "type_row_data",
                          "width"
                        ],
                        "additionalProperties": true
                      }
                    }
                  ],
                  "description": "Column array validated by native _before_addTable and _update_table_columns. Per-column required fields and scalar rejection types are derived from TableColumns. Unknown column keys are dropped by the native validator. Both lists and keyed objects are iterable native inputs; each value is validated as one column.",
                  "x-edoobox-hookDefinition": {
                    "class": "Layoutfunc",
                    "property": "TableColumns",
                    "validator": "validateColumns",
                    "description": "Column array validated by native _before_addTable and _update_table_columns. Per-column required fields and scalar rejection types are derived from TableColumns. Unknown column keys are dropped by the native validator. Both lists and keyed objects are iterable native inputs; each value is validated as one column."
                  },
                  "x-edoobox-sourceLine": 303
                },
                "last_change": false
              },
              "additionalProperties": true
            }
          },
          "additionalProperties": true
        },
        "examples": {
          "rename": {
            "summary": "Synthetic supported request; replace all IDs with values read from this account.",
            "value": {
              "data": {
                "name": "Renamed layout"
              }
            }
          }
        }
      }
    }
  },
  "x-edoobox-action-contract": {
    "review": "layout-table-put",
    "status": "source-reviewed-partial",
    "sources": [
      {
        "file": "application/models/v2/Layout.php",
        "sha256": "d5bf4faf862da921710d9d2f553b14778a2b78eb8281a2f195dd5d52f9886eaf",
        "methods": [
          "__construct",
          "setStructure_Table",
          "postLayout",
          "updateLayout"
        ]
      },
      {
        "file": "application/models/v2/API_DATA.php",
        "sha256": "c0e15d26a7a4f3fb3c25e35557d4420ad395b2af3925caec292de08e32ebf44c",
        "methods": [
          "return_insert_data",
          "return_update_data"
        ]
      },
      {
        "file": "application/models/v2/Layoutfunc.php",
        "sha256": "04d3a25db87fd8c8e5f6fd8b6ec9cb899bf3d0bafcc7f286b76381c9e28afdc1",
        "methods": [
          "_before_addTable",
          "_update_table_columns",
          "validateColumns"
        ]
      }
    ],
    "preconditions": [
      "Only the selected account owns or changes the layout; placeholder and template expansion use native account context."
    ],
    "errors": [
      {
        "error": "ED80100",
        "meaning": "Required create fields, rejected getter value, or native write validation failed."
      },
      {
        "error": "ED80023",
        "meaning": "Generic batch create exceeds 100 records."
      },
      {
        "error": "ED80100",
        "error_code": "columns_structure_error"
      }
    ],
    "unresolved": [
      "Template placeholders, account data, signed ID integrity and rendering output remain native. Scalar getter coercion is documented without inventing rejecting wire limits."
    ]
  },
  "x-edoobox-runtimeMutationGuard": true,
  "x-edoobox-documentationReview": {
    "file": "docs/openapi/operation-contracts/07-layout-files.json",
    "notes": []
  },
  "x-edoobox-source": {
    "file": "application/models/v2/Layout.php",
    "method": "updateLayout",
    "line": 531
  },
  "x-edoobox-documentationStatus": "reviewed",
  "x-edoobox-readOnly": false,
  "x-edoobox-safeForAutomation": false,
  "x-edoobox-permission": {
    "resource": "layout",
    "short": "lyot",
    "checkedByDispatcher": true,
    "levels": [
      3,
      4
    ],
    "description": "Resource permission mapping from APIPermissions(), Authfunc::_getCheckJWT. Additional model/admin/plugin checks may apply; resources absent from api_permission do not acquire a fictitious scope."
  }
}