{
  "components": {
    "schemas": {
      "APIError": {
        "additionalProperties": false,
        "properties": {
          "error": {
            "additionalProperties": false,
            "description": "The stable error envelope returned for a failed API request.",
            "properties": {
              "code": {
                "description": "Stable machine-readable Pūnaha error code.",
                "example": "PERMISSION_REQUIRED",
                "pattern": "^[A-Z][A-Z0-9_]+$",
                "type": "string",
                "x-punaha-access": "Inherits the operation access boundary.",
                "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
                "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only response value.",
                "x-punaha-presence": "required",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
              },
              "details": {
                "description": "Error-code-specific diagnostic values. The operation error catalogue documents their meaning; they may be null when no safe detail is available.",
                "example": {
                  "permission": "workflows.manage"
                },
                "type": [
                  "object",
                  "array",
                  "string",
                  "number",
                  "integer",
                  "boolean",
                  "null"
                ],
                "x-punaha-access": "Inherits the operation access boundary.",
                "x-punaha-arbitrary": true,
                "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
                "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only response value.",
                "x-punaha-presence": "required",
                "x-punaha-sensitive": true,
                "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
              },
              "message": {
                "description": "Human-readable explanation of the failure. Do not parse this text for control flow.",
                "example": "The exact permission or resource action is required.",
                "minLength": 1,
                "type": "string",
                "x-punaha-access": "Inherits the operation access boundary.",
                "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
                "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only response value.",
                "x-punaha-presence": "required",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
              }
            },
            "required": [
              "code",
              "message",
              "details"
            ],
            "type": "object",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      },
      "CaseworkCMMNArtifactRequest": {
        "additionalProperties": false,
        "properties": {
          "direction": {
            "description": "The direction associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targetRef": {
            "description": "The target ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "text": {
            "description": "The text associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "textFormat": {
            "description": "The text format associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "CaseworkCMMNArtifactResponse": {
        "additionalProperties": false,
        "properties": {
          "direction": {
            "description": "The direction associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "targetRef": {
            "description": "The target ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "text": {
            "description": "The text associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "textFormat": {
            "description": "The text format associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "CaseworkCMMNDiagramRequest": {
        "additionalProperties": false,
        "properties": {
          "edges": {
            "description": "The edges associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNEdgeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "height": {
            "description": "The height associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "shapes": {
            "description": "The shapes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNShapeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "width": {
            "description": "The width associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "CaseworkCMMNDiagramResponse": {
        "additionalProperties": false,
        "properties": {
          "edges": {
            "description": "The edges associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNEdgeResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "height": {
            "description": "The height associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "shapes": {
            "description": "The shapes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNShapeResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "width": {
            "description": "The width associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "type": "object"
      },
      "CaseworkCMMNEdgeRequest": {
        "additionalProperties": false,
        "properties": {
          "elementRef": {
            "description": "The element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "standardEventVisible": {
            "description": "The standard event visible associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targetRef": {
            "description": "The target ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waypoints": {
            "description": "The waypoints associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNWaypointRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "waypoints"
        ],
        "type": "object"
      },
      "CaseworkCMMNEdgeResponse": {
        "additionalProperties": false,
        "properties": {
          "elementRef": {
            "description": "The element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "standardEventVisible": {
            "description": "The standard event visible associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "targetRef": {
            "description": "The target ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "waypoints": {
            "description": "The waypoints associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNWaypointResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "waypoints"
        ],
        "type": "object"
      },
      "CaseworkCMMNReportResponse": {
        "additionalProperties": false,
        "properties": {
          "exactRoundTrip": {
            "description": "The exact round trip associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "imported": {
            "description": "The imported associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "schemaValid": {
            "description": "The schema valid associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "semanticSha256": {
            "description": "The semantic sha256 associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourcePreserved": {
            "description": "The source preserved associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourceSha256": {
            "description": "The source sha256 associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "standard": {
            "description": "The standard associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "validation": {
            "$ref": "#/components/schemas/CaseworkCMMNValidationReportResponse",
            "description": "The validation associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "warnings": {
            "description": "The warnings associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "exactRoundTrip",
          "imported",
          "schemaValid",
          "semanticSha256",
          "sourcePreserved",
          "sourceSha256",
          "standard",
          "validation",
          "version",
          "warnings"
        ],
        "type": "object"
      },
      "CaseworkCMMNShapeRequest": {
        "additionalProperties": false,
        "properties": {
          "collapsed": {
            "description": "The collapsed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementRef": {
            "description": "The element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "height": {
            "description": "The height associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "planningTableCollapsed": {
            "description": "The planning table collapsed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "width": {
            "description": "The width associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "elementRef",
          "height",
          "id",
          "width",
          "x",
          "y"
        ],
        "type": "object"
      },
      "CaseworkCMMNShapeResponse": {
        "additionalProperties": false,
        "properties": {
          "collapsed": {
            "description": "The collapsed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "elementRef": {
            "description": "The element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "height": {
            "description": "The height associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "planningTableCollapsed": {
            "description": "The planning table collapsed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "width": {
            "description": "The width associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "elementRef",
          "height",
          "id",
          "width",
          "x",
          "y"
        ],
        "type": "object"
      },
      "CaseworkCMMNValidationDiagnosticResponse": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "description": "A stable machine-readable code for the represented condition.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "column": {
            "description": "The column associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "line": {
            "description": "The line associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "message": {
            "description": "A human-readable explanation intended to help understand the result.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "path": {
            "description": "The path associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "code",
          "message"
        ],
        "type": "object"
      },
      "CaseworkCMMNValidationReportResponse": {
        "additionalProperties": false,
        "properties": {
          "diagnostics": {
            "description": "The diagnostics associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNValidationDiagnosticResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "namespace": {
            "description": "The namespace associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "schemaValid": {
            "description": "The schema valid associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "standard": {
            "description": "The standard associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "schemaValid",
          "standard",
          "status",
          "version"
        ],
        "type": "object"
      },
      "CaseworkCMMNWaypointRequest": {
        "additionalProperties": false,
        "properties": {
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "x",
          "y"
        ],
        "type": "object"
      },
      "CaseworkCMMNWaypointResponse": {
        "additionalProperties": false,
        "properties": {
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "x",
          "y"
        ],
        "type": "object"
      },
      "CaseworkCaseFileItemDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "definitionRef": {
            "description": "The definition ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "definitionType": {
            "description": "The definition type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "multiplicity": {
            "description": "The multiplicity associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "parentId": {
            "description": "The parent id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "properties": {
            "description": "The properties associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCaseFilePropertyRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "structureRef": {
            "description": "The structure ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targetRefs": {
            "description": "The target refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "definitionRef",
          "id",
          "multiplicity",
          "name"
        ],
        "type": "object"
      },
      "CaseworkCaseFileItemDefinitionResponse": {
        "additionalProperties": false,
        "properties": {
          "definitionRef": {
            "description": "The definition ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "definitionType": {
            "description": "The definition type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "multiplicity": {
            "description": "The multiplicity associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "parentId": {
            "description": "The parent id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "properties": {
            "description": "The properties associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCaseFilePropertyResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "structureRef": {
            "description": "The structure ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "targetRefs": {
            "description": "The target refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "definitionRef",
          "id",
          "multiplicity",
          "name"
        ],
        "type": "object"
      },
      "CaseworkCaseFilePropertyRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "CaseworkCaseFilePropertyResponse": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "CaseworkControlRuleRequest": {
        "additionalProperties": false,
        "properties": {
          "condition": {
            "description": "The condition associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sentryRef": {
            "description": "The sentry ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "CaseworkControlRuleResponse": {
        "additionalProperties": false,
        "properties": {
          "condition": {
            "description": "The condition associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sentryRef": {
            "description": "The sentry ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "type": "object"
      },
      "CaseworkCorrelatedEventInputRequest": {
        "additionalProperties": false,
        "properties": {
          "correlationKey": {
            "description": "The correlation key associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "eventType": {
            "description": "The event type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "idempotencyKey": {
            "description": "The idempotency key associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "payload": {
            "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "correlationKey",
          "eventType",
          "idempotencyKey",
          "payload"
        ],
        "type": "object"
      },
      "CaseworkCreateTypeInputRequest": {
        "additionalProperties": false,
        "properties": {
          "definition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkDefinitionRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The definition associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "slug": {
            "description": "The slug associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "description",
          "displayName",
          "slug"
        ],
        "type": "object"
      },
      "CaseworkCriterionRequest": {
        "additionalProperties": false,
        "properties": {
          "expressionLanguage": {
            "description": "The expression language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "operator": {
            "description": "The operator associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "source": {
            "description": "The source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "value": {
            "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "operator",
          "source"
        ],
        "type": "object"
      },
      "CaseworkCriterionResponse": {
        "additionalProperties": false,
        "properties": {
          "expressionLanguage": {
            "description": "The expression language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "operator": {
            "description": "The operator associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "source": {
            "description": "The source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "value": {
            "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "operator",
          "source"
        ],
        "type": "object"
      },
      "CaseworkDecisionInputRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "label"
        ],
        "type": "object"
      },
      "CaseworkDecisionInputResponse": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "label"
        ],
        "type": "object"
      },
      "CaseworkDecisionOutputRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "label"
        ],
        "type": "object"
      },
      "CaseworkDecisionOutputResponse": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "label"
        ],
        "type": "object"
      },
      "CaseworkDecisionRuleRequest": {
        "additionalProperties": false,
        "properties": {
          "conditions": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outputs": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "conditions",
          "id",
          "outputs"
        ],
        "type": "object"
      },
      "CaseworkDecisionRuleResponse": {
        "additionalProperties": false,
        "properties": {
          "conditions": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "outputs": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "conditions",
          "id",
          "outputs"
        ],
        "type": "object"
      },
      "CaseworkDecisionTableRequest": {
        "additionalProperties": false,
        "properties": {
          "hitPolicy": {
            "description": "The hit policy associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "inputs": {
            "description": "The inputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkDecisionInputRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outputs": {
            "description": "The outputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkDecisionOutputRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "rules": {
            "description": "The rules associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkDecisionRuleRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "hitPolicy",
          "id",
          "inputs",
          "name",
          "outputs",
          "rules"
        ],
        "type": "object"
      },
      "CaseworkDecisionTableResponse": {
        "additionalProperties": false,
        "properties": {
          "hitPolicy": {
            "description": "The hit policy associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "inputs": {
            "description": "The inputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkDecisionInputResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "outputs": {
            "description": "The outputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkDecisionOutputResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "rules": {
            "description": "The rules associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkDecisionRuleResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "hitPolicy",
          "id",
          "inputs",
          "name",
          "outputs",
          "rules"
        ],
        "type": "object"
      },
      "CaseworkDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "artifacts": {
            "description": "The artifacts associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNArtifactRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "caseFile": {
            "description": "The case file associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCaseFileItemDefinitionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "diagram": {
            "$ref": "#/components/schemas/CaseworkCMMNDiagramRequest",
            "description": "The diagram associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "fields": {
            "description": "The fields associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkFieldRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "format": {
            "description": "The format associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outcomes": {
            "description": "The outcomes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "policies": {
            "$ref": "#/components/schemas/CaseworkPoliciesRequest",
            "description": "The policies associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "purpose": {
            "description": "The purpose associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "requirements": {
            "description": "The requirements associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkRequirementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "roles": {
            "description": "The roles associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkRoleRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "schemaVersion": {
            "description": "The schema version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sentries": {
            "description": "The sentries associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkSentryRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "stages": {
            "description": "The stages associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkStageRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "fields",
          "format",
          "outcomes",
          "policies",
          "purpose",
          "requirements",
          "roles",
          "schemaVersion",
          "stages"
        ],
        "type": "object"
      },
      "CaseworkDefinitionResponse": {
        "additionalProperties": false,
        "properties": {
          "artifacts": {
            "description": "The artifacts associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCMMNArtifactResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "caseFile": {
            "description": "The case file associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCaseFileItemDefinitionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "diagram": {
            "$ref": "#/components/schemas/CaseworkCMMNDiagramResponse",
            "description": "The diagram associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "fields": {
            "description": "The fields associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkFieldResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "format": {
            "description": "The format associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "outcomes": {
            "description": "The outcomes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "policies": {
            "$ref": "#/components/schemas/CaseworkPoliciesResponse",
            "description": "The policies associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "purpose": {
            "description": "The purpose associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requirements": {
            "description": "The requirements associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkRequirementResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "roles": {
            "description": "The roles associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkRoleResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "schemaVersion": {
            "description": "The schema version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sentries": {
            "description": "The sentries associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkSentryResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "stages": {
            "description": "The stages associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkStageResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "fields",
          "format",
          "outcomes",
          "policies",
          "purpose",
          "requirements",
          "roles",
          "schemaVersion",
          "stages"
        ],
        "type": "object"
      },
      "CaseworkDueRuleRequest": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "description": "The amount associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "from": {
            "description": "The from associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "unit": {
            "description": "The unit associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "amount",
          "from",
          "unit"
        ],
        "type": "object"
      },
      "CaseworkDueRuleResponse": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "description": "The amount associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "from": {
            "description": "The from associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "unit": {
            "description": "The unit associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "amount",
          "from",
          "unit"
        ],
        "type": "object"
      },
      "CaseworkFieldRequest": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "maximum": {
            "anyOf": [
              {
                "format": "double",
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The maximum associated with this resource or operation.",
            "example": 1.5,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "minimum": {
            "anyOf": [
              {
                "format": "double",
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The minimum associated with this resource or operation.",
            "example": 1.5,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "options": {
            "description": "The options associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "requiredAtStart": {
            "description": "The required at start associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sensitive": {
            "description": "The sensitive associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "label",
          "type"
        ],
        "type": "object"
      },
      "CaseworkFieldResponse": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "maximum": {
            "anyOf": [
              {
                "format": "double",
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The maximum associated with this resource or operation.",
            "example": 1.5,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "minimum": {
            "anyOf": [
              {
                "format": "double",
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The minimum associated with this resource or operation.",
            "example": 1.5,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "options": {
            "description": "The options associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requiredAtStart": {
            "description": "The required at start associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sensitive": {
            "description": "The sensitive associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "label",
          "type"
        ],
        "type": "object"
      },
      "CaseworkOnPartRequest": {
        "additionalProperties": false,
        "properties": {
          "exitCriterionRef": {
            "description": "The exit criterion ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceType": {
            "description": "The source type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "standardEvent": {
            "description": "The standard event associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "sourceRef",
          "sourceType",
          "standardEvent"
        ],
        "type": "object"
      },
      "CaseworkOnPartResponse": {
        "additionalProperties": false,
        "properties": {
          "exitCriterionRef": {
            "description": "The exit criterion ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourceType": {
            "description": "The source type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "standardEvent": {
            "description": "The standard event associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "sourceRef",
          "sourceType",
          "standardEvent"
        ],
        "type": "object"
      },
      "CaseworkParameterMappingRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "source": {
            "description": "The source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "target": {
            "description": "The target associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "transformation": {
            "description": "The transformation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "source",
          "target"
        ],
        "type": "object"
      },
      "CaseworkParameterMappingResponse": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "source": {
            "description": "The source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "target": {
            "description": "The target associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "transformation": {
            "description": "The transformation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "source",
          "target"
        ],
        "type": "object"
      },
      "CaseworkPlanItemControlRequest": {
        "additionalProperties": false,
        "properties": {
          "manualActivation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkControlRuleRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The manual activation associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "repetition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkControlRuleRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The repetition associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "required": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkControlRuleRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The required associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "CaseworkPlanItemControlResponse": {
        "additionalProperties": false,
        "properties": {
          "manualActivation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkControlRuleResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The manual activation associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "repetition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkControlRuleResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The repetition associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "required": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkControlRuleResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The required associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "type": "object"
      },
      "CaseworkPlanItemRequest": {
        "additionalProperties": false,
        "properties": {
          "authorizedRoles": {
            "description": "The authorized roles associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "blocking": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The blocking associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "caseTypeId": {
            "description": "The case type id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "caseTypeVersion": {
            "description": "The case type version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "children": {
            "description": "The children associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkPlanItemRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "control": {
            "$ref": "#/components/schemas/CaseworkPlanItemControlRequest",
            "description": "The control associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "correlationField": {
            "description": "The correlation field associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "decision": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkDecisionTableRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The decision associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "definitionRef": {
            "description": "The definition ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "due": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkDueRuleRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The due associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "entryCriteria": {
            "description": "The entry criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "entrySentryRefs": {
            "description": "The entry sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "eventType": {
            "description": "The event type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "exitCriteria": {
            "description": "The exit criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "exitSentryRefs": {
            "description": "The exit sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "externalImportType": {
            "description": "The external import type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "externalLocation": {
            "description": "The external location associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "externalNamespace": {
            "description": "The external namespace associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "externalPrefix": {
            "description": "The external prefix associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "externalRef": {
            "description": "The external ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "implementationType": {
            "description": "The implementation type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "input": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "inputMappings": {
            "description": "The input mappings associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkParameterMappingRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "manualActivation": {
            "description": "The manual activation associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outputMappings": {
            "description": "The output mappings associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkParameterMappingRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "planningTable": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkPlanningTableRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The planning table associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "repeatable": {
            "description": "The repeatable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "required": {
            "description": "The required associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "roleId": {
            "description": "The role id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "timeoutMinutes": {
            "description": "The timeout minutes associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "timerExpression": {
            "description": "The timer expression associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "timerStart": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkOnPartRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The timer start associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "workflowId": {
            "description": "The workflow id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "workflowVersion": {
            "description": "The workflow version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "name",
          "required",
          "type"
        ],
        "type": "object"
      },
      "CaseworkPlanItemResponse": {
        "additionalProperties": false,
        "properties": {
          "authorizedRoles": {
            "description": "The authorized roles associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "blocking": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The blocking associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "caseTypeId": {
            "description": "The case type id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "caseTypeVersion": {
            "description": "The case type version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "children": {
            "description": "The children associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkPlanItemResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "control": {
            "$ref": "#/components/schemas/CaseworkPlanItemControlResponse",
            "description": "The control associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "correlationField": {
            "description": "The correlation field associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "decision": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkDecisionTableResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The decision associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "definitionRef": {
            "description": "The definition ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "due": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkDueRuleResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The due associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "entryCriteria": {
            "description": "The entry criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "entrySentryRefs": {
            "description": "The entry sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "eventType": {
            "description": "The event type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "exitCriteria": {
            "description": "The exit criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "exitSentryRefs": {
            "description": "The exit sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "externalImportType": {
            "description": "The external import type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "externalLocation": {
            "description": "The external location associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "externalNamespace": {
            "description": "The external namespace associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "externalPrefix": {
            "description": "The external prefix associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "externalRef": {
            "description": "The external ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "implementationType": {
            "description": "The implementation type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "input": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "inputMappings": {
            "description": "The input mappings associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkParameterMappingResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "manualActivation": {
            "description": "The manual activation associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "outputMappings": {
            "description": "The output mappings associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkParameterMappingResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "planningTable": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkPlanningTableResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The planning table associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "repeatable": {
            "description": "The repeatable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "required": {
            "description": "The required associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "roleId": {
            "description": "The role id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "timeoutMinutes": {
            "description": "The timeout minutes associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "timerExpression": {
            "description": "The timer expression associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "timerStart": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkOnPartResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The timer start associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "workflowId": {
            "description": "The workflow id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "workflowVersion": {
            "description": "The workflow version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "name",
          "required",
          "type"
        ],
        "type": "object"
      },
      "CaseworkPlanningTableRequest": {
        "additionalProperties": false,
        "properties": {
          "applicabilityRules": {
            "description": "The applicability rules associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "authorizedRoles": {
            "description": "The authorized roles associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "itemRefs": {
            "description": "The item refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "tables": {
            "description": "The tables associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkPlanningTableRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "CaseworkPlanningTableResponse": {
        "additionalProperties": false,
        "properties": {
          "applicabilityRules": {
            "description": "The applicability rules associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "authorizedRoles": {
            "description": "The authorized roles associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "itemRefs": {
            "description": "The item refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "tables": {
            "description": "The tables associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkPlanningTableResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "CaseworkPoliciesRequest": {
        "additionalProperties": false,
        "properties": {
          "allowReopen": {
            "description": "The allow reopen associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "classification": {
            "description": "The classification associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "completionMode": {
            "description": "The completion mode associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "retentionDays": {
            "description": "The retention days associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "allowReopen",
          "completionMode"
        ],
        "type": "object"
      },
      "CaseworkPoliciesResponse": {
        "additionalProperties": false,
        "properties": {
          "allowReopen": {
            "description": "The allow reopen associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "classification": {
            "description": "The classification associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "completionMode": {
            "description": "The completion mode associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "retentionDays": {
            "description": "The retention days associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "allowReopen",
          "completionMode"
        ],
        "type": "object"
      },
      "CaseworkRequirementRequest": {
        "additionalProperties": false,
        "properties": {
          "appliesWhen": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkCriterionRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The applies when associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "blocksCompletion": {
            "description": "The blocks completion associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "due": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkDueRuleRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The due associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "enforcement": {
            "description": "The enforcement associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "fieldId": {
            "description": "The field id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "milestoneId": {
            "description": "The milestone id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "planItemId": {
            "description": "The plan item id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "responsibleRole": {
            "description": "The responsible role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "stageId": {
            "description": "The stage id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waivable": {
            "description": "The waivable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waiverRole": {
            "description": "The waiver role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "blocksCompletion",
          "enforcement",
          "id",
          "name",
          "type",
          "waivable"
        ],
        "type": "object"
      },
      "CaseworkRequirementResponse": {
        "additionalProperties": false,
        "properties": {
          "appliesWhen": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkCriterionResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The applies when associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "blocksCompletion": {
            "description": "The blocks completion associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "due": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkDueRuleResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The due associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "enforcement": {
            "description": "The enforcement associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "fieldId": {
            "description": "The field id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "milestoneId": {
            "description": "The milestone id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "planItemId": {
            "description": "The plan item id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "responsibleRole": {
            "description": "The responsible role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "stageId": {
            "description": "The stage id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "waivable": {
            "description": "The waivable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "waiverRole": {
            "description": "The waiver role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "blocksCompletion",
          "enforcement",
          "id",
          "name",
          "type",
          "waivable"
        ],
        "type": "object"
      },
      "CaseworkRoleRequest": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "CaseworkRoleResponse": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "CaseworkSentryRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "ifPart": {
            "description": "The if part associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "onParts": {
            "description": "The on parts associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkOnPartRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "CaseworkSentryResponse": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "ifPart": {
            "description": "The if part associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "onParts": {
            "description": "The on parts associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkOnPartResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "CaseworkStageRequest": {
        "additionalProperties": false,
        "properties": {
          "autoComplete": {
            "description": "The auto complete associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "control": {
            "$ref": "#/components/schemas/CaseworkPlanItemControlRequest",
            "description": "The control associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "entryCriteria": {
            "description": "The entry criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "entrySentryRefs": {
            "description": "The entry sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "exitCriteria": {
            "description": "The exit criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "exitSentryRefs": {
            "description": "The exit sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "items": {
            "description": "The records included in this collection.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkPlanItemRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "manualActivation": {
            "description": "The manual activation associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "parentId": {
            "description": "The parent id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "planningTable": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkPlanningTableRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The planning table associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "repeatable": {
            "description": "The repeatable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "required": {
            "description": "The required associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "items",
          "name",
          "required"
        ],
        "type": "object"
      },
      "CaseworkStageResponse": {
        "additionalProperties": false,
        "properties": {
          "autoComplete": {
            "description": "The auto complete associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "control": {
            "$ref": "#/components/schemas/CaseworkPlanItemControlResponse",
            "description": "The control associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "entryCriteria": {
            "description": "The entry criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "entrySentryRefs": {
            "description": "The entry sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "exitCriteria": {
            "description": "The exit criteria associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkCriterionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "exitSentryRefs": {
            "description": "The exit sentry refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "items": {
            "description": "The records included in this collection.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/CaseworkPlanItemResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "manualActivation": {
            "description": "The manual activation associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "parentId": {
            "description": "The parent id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "planningTable": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaseworkPlanningTableResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The planning table associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "repeatable": {
            "description": "The repeatable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "required": {
            "description": "The required associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "items",
          "name",
          "required"
        ],
        "type": "object"
      },
      "ChatCompletedEvent": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "contentMediaType": "application/json",
            "contentSchema": {
              "$ref": "#/components/schemas/ModelsChatResult"
            },
            "description": "JSON-encoded direct final ChatResult; no data envelope is present in this event payload.",
            "example": "{\"model\":\"example-model\",\"message\":{\"role\":\"assistant\",\"content\":\"Hello.\"}}",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "event": {
            "const": "chat.completed",
            "description": "The chat event type that selects the data payload schema.",
            "example": "chat.completed",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "event",
          "data"
        ],
        "type": "object"
      },
      "ChatDeltaData": {
        "additionalProperties": false,
        "properties": {
          "content": {
            "description": "Incremental text fragment. Append fragments in arrival order; the complete successful message is also returned by chat.completed.",
            "example": "Hello.",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "content"
        ],
        "type": "object"
      },
      "ChatDeltaEvent": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "contentMediaType": "application/json",
            "contentSchema": {
              "$ref": "#/components/schemas/ChatDeltaData"
            },
            "description": "JSON-encoded incremental content object, not a bare JSON string.",
            "example": "{\"content\":\"Hello.\"}",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "event": {
            "const": "chat.delta",
            "description": "The chat event type that selects the data payload schema.",
            "example": "chat.delta",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "event",
          "data"
        ],
        "type": "object"
      },
      "ChatFailedData": {
        "additionalProperties": false,
        "properties": {
          "error": {
            "additionalProperties": false,
            "description": "Terminal stream error after events have started. Partial content is incomplete and no final ChatResult follows.",
            "properties": {
              "code": {
                "const": "CHAT_STREAM_FAILED",
                "description": "Stable stream-failure code.",
                "example": "CHAT_STREAM_FAILED",
                "type": "string",
                "x-punaha-access": "Inherits the operation access boundary.",
                "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
                "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only response value.",
                "x-punaha-presence": "required",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
              },
              "message": {
                "description": "Safe explanation of the incomplete generation.",
                "example": "Chat generation did not complete.",
                "type": "string",
                "x-punaha-access": "Inherits the operation access boundary.",
                "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
                "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only response value.",
                "x-punaha-presence": "required",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
              }
            },
            "required": [
              "code",
              "message"
            ],
            "type": "object",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      },
      "ChatFailedEvent": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "contentMediaType": "application/json",
            "contentSchema": {
              "$ref": "#/components/schemas/ChatFailedData"
            },
            "description": "JSON-encoded terminal stream error object with code and message; unlike an ordinary APIError, it has no details property.",
            "example": "{\"error\":{\"code\":\"CHAT_STREAM_FAILED\",\"message\":\"Chat generation did not complete.\"}}",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "event": {
            "const": "chat.failed",
            "description": "The chat event type that selects the data payload schema.",
            "example": "chat.failed",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "event",
          "data"
        ],
        "type": "object"
      },
      "ChatResponse": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ModelsChatResult",
            "description": "Completed chat result in the ordinary JSON response envelope.",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "ChatServerSentEvent": {
        "description": "Parsed chat SSE frame. Decode its data string as JSON using the schema selected by event. The handler emits no id or retry fields and provides no replay protocol.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/ChatDeltaEvent"
          },
          {
            "$ref": "#/components/schemas/ChatCompletedEvent"
          },
          {
            "$ref": "#/components/schemas/ChatFailedEvent"
          }
        ]
      },
      "ConnectionsDefinitionResponse": {
        "additionalProperties": false,
        "properties": {
          "authenticationType": {
            "description": "The authentication type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "clientId": {
            "description": "The client id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "configuration": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "connectionType": {
            "description": "The connection type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "databaseName": {
            "description": "The database name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "enabled": {
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "endpoint": {
            "description": "The endpoint associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "host": {
            "description": "The host associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "lastTestMessage": {
            "description": "The last test message associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "lastTestStatus": {
            "description": "The last test status associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "lastTestedAt": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The last tested at associated with this resource or operation.",
            "example": "2026-08-28T00:00:00Z",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "port": {
            "description": "The port associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "secretStatus": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": "example-value-not-a-real-secret",
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "tenantId": {
            "description": "The tenant identifier that owns or scopes the resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "tlsMode": {
            "description": "The tls mode associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "username": {
            "description": "The username associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "authenticationType",
          "configuration",
          "connectionType",
          "createdAt",
          "description",
          "enabled",
          "id",
          "lastTestStatus",
          "name",
          "organizationId",
          "secretStatus",
          "tlsMode",
          "updatedAt"
        ],
        "type": "object"
      },
      "ConnectionsInputRequest": {
        "additionalProperties": false,
        "properties": {
          "authenticationType": {
            "description": "The authentication type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "clearSecrets": {
            "description": "The clear secrets associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "clientId": {
            "description": "The client id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "configuration": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "connectionType": {
            "description": "The connection type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "databaseName": {
            "description": "The database name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "endpoint": {
            "description": "The endpoint associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "host": {
            "description": "The host associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "port": {
            "description": "The port associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "secrets": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": "example-value-not-a-real-secret",
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "tenantId": {
            "description": "The tenant identifier that owns or scopes the resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "tlsMode": {
            "description": "The tls mode associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "username": {
            "description": "The username associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "authenticationType",
          "clearSecrets",
          "clientId",
          "configuration",
          "connectionType",
          "databaseName",
          "description",
          "endpoint",
          "host",
          "name",
          "port",
          "secrets",
          "tenantId",
          "tlsMode",
          "username"
        ],
        "type": "object"
      },
      "ConnectionsOptionResponse": {
        "additionalProperties": false,
        "properties": {
          "connectionType": {
            "description": "The connection type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "enabled": {
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "connectionType",
          "enabled",
          "id",
          "name"
        ],
        "type": "object"
      },
      "DatabaseCaseCorrelatedEventRecordResponse": {
        "additionalProperties": false,
        "properties": {
          "consumedByCaseId": {
            "description": "The consumed by case id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "correlationKey": {
            "description": "The correlation key associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "eventType": {
            "description": "The event type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "idempotencyKey": {
            "description": "The idempotency key associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "payload": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "receivedAt": {
            "description": "The received at associated with this resource or operation.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "receivedBy": {
            "description": "The received by associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "correlationKey",
          "eventType",
          "id",
          "idempotencyKey",
          "organizationId",
          "payload",
          "receivedAt"
        ],
        "type": "object"
      },
      "DatabaseCaseTypeRecordResponse": {
        "additionalProperties": false,
        "properties": {
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdBy": {
            "description": "The created by associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "definition": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "publishedVersion": {
            "anyOf": [
              {
                "format": "int64",
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The published version associated with this resource or operation.",
            "example": 1,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "slug": {
            "description": "The slug associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "createdAt",
          "definition",
          "description",
          "displayName",
          "id",
          "organizationId",
          "slug",
          "status",
          "updatedAt"
        ],
        "type": "object"
      },
      "DatabaseWorkflowRecordResponse": {
        "additionalProperties": false,
        "properties": {
          "access": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "definition": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "folderId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The folder id associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "publishedVersion": {
            "anyOf": [
              {
                "format": "int64",
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The published version associated with this resource or operation.",
            "example": 1,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "slug": {
            "description": "The slug associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "createdAt",
          "definition",
          "description",
          "displayName",
          "id",
          "organizationId",
          "slug",
          "status",
          "updatedAt"
        ],
        "type": "object"
      },
      "DatabaseWorkflowRunRecordResponse": {
        "additionalProperties": false,
        "properties": {
          "completedAt": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The completed at associated with this resource or operation.",
            "example": "2026-08-28T00:00:00Z",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdBy": {
            "description": "The created by associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "errorCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The error code associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "errorMessage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The error message associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "input": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "isDraftTest": {
            "description": "The is draft test associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "output": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "priority": {
            "description": "The priority associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resumeAt": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The resume at associated with this resource or operation.",
            "example": "2026-08-28T00:00:00Z",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "runKind": {
            "description": "The run kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "serverId": {
            "description": "The server id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "startedAt": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The started at associated with this resource or operation.",
            "example": "2026-08-28T00:00:00Z",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "state": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "stateRevision": {
            "description": "The state revision associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "threadId": {
            "description": "The thread id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "waitKind": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The wait kind associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "waitingNodeId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The waiting node id associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "workflowId": {
            "description": "The workflow id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "workflowVersion": {
            "description": "The workflow version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "createdAt",
          "id",
          "input",
          "isDraftTest",
          "organizationId",
          "priority",
          "runKind",
          "state",
          "stateRevision",
          "status",
          "threadId",
          "updatedAt",
          "workflowId",
          "workflowVersion"
        ],
        "type": "object"
      },
      "DmnFunctionParamResponse": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "typeRef": {
            "description": "The type ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "DmnLogicVisualChildResponse": {
        "additionalProperties": false,
        "properties": {
          "expression": {
            "$ref": "#/components/schemas/DmnLogicVisualResponse",
            "description": "The expression associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "role": {
            "description": "The role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "typeRef": {
            "description": "The type ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "expression",
          "role"
        ],
        "type": "object"
      },
      "DmnLogicVisualResponse": {
        "additionalProperties": false,
        "properties": {
          "aggregation": {
            "description": "The aggregation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "children": {
            "description": "The children associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/DmnLogicVisualChildResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "columns": {
            "description": "The columns associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "hitPolicy": {
            "description": "The hit policy associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "inputs": {
            "description": "The inputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/DmnTableInputResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "kind": {
            "description": "The kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "outputs": {
            "description": "The outputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/DmnTableOutputResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "params": {
            "description": "The params associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/DmnFunctionParamResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "rows": {
            "description": "The rows associated with this resource or operation.",
            "example": [
              [
                "example-value"
              ]
            ],
            "items": {
              "example": [
                "example-value"
              ],
              "items": {
                "$ref": "#/components/schemas/DmnLogicVisualResponse"
              },
              "type": "array"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "rules": {
            "description": "The rules associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/DmnTableRuleResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "text": {
            "description": "The text associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "typeRef": {
            "description": "The type ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "variable": {
            "description": "The variable associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "kind"
        ],
        "type": "object"
      },
      "DmnTableInputResponse": {
        "additionalProperties": false,
        "properties": {
          "expression": {
            "description": "The expression associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "typeRef": {
            "description": "The type ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "expression"
        ],
        "type": "object"
      },
      "DmnTableOutputResponse": {
        "additionalProperties": false,
        "properties": {
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "typeRef": {
            "description": "The type ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "type": "object"
      },
      "DmnTableRuleResponse": {
        "additionalProperties": false,
        "properties": {
          "annotations": {
            "description": "The annotations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "inputEntries": {
            "description": "The input entries associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "outputEntries": {
            "description": "The output entries associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "inputEntries",
          "outputEntries"
        ],
        "type": "object"
      },
      "DomainDocumentProcessingOptionsResponse": {
        "additionalProperties": false,
        "properties": {
          "gpuUtilizationTargetPercent": {
            "description": "The gpu utilization target percent associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "maximum": 100,
            "minimum": 1,
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "maxParallelSections": {
            "description": "The max parallel sections associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "maximum": 8,
            "minimum": 0,
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "gpuUtilizationTargetPercent",
          "maxParallelSections"
        ],
        "type": "object"
      },
      "DomainDocumentResponse": {
        "additionalProperties": false,
        "properties": {
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "databaseName": {
            "description": "The database name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "fileName": {
            "description": "The file name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "metadata": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "mimeType": {
            "description": "The mime type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sectionCount": {
            "description": "The section count associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sizeBytes": {
            "description": "The size bytes associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "title": {
            "description": "The title associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "toc": {
            "description": "The toc associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/DomainTOCEntryResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "createdAt",
          "databaseName",
          "description",
          "fileName",
          "id",
          "mimeType",
          "organizationId",
          "sectionCount",
          "sizeBytes",
          "status",
          "title",
          "toc",
          "updatedAt"
        ],
        "type": "object"
      },
      "DomainEmbeddingModelConfigurationRequest": {
        "additionalProperties": false,
        "properties": {
          "available": {
            "description": "The available associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "contextTokens": {
            "description": "The context tokens associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dimensions": {
            "description": "The dimensions associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "local": {
            "description": "The local associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "provider": {
            "description": "The provider associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "runtime": {
            "description": "The runtime associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "available",
          "dimensions",
          "id",
          "local",
          "name",
          "provider",
          "runtime",
          "status"
        ],
        "type": "object"
      },
      "DomainIngestionJobResponse": {
        "additionalProperties": false,
        "properties": {
          "attempt": {
            "description": "The attempt associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "completedSections": {
            "description": "The completed sections associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdBy": {
            "description": "The created by associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "databaseName": {
            "description": "The database name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "documentId": {
            "description": "The document id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "errorCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The error code associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "errorMessage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The error message associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "fileName": {
            "description": "The file name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "maximumAttempts": {
            "description": "The maximum attempts associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "priority": {
            "description": "The priority associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "processing": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "processingOptions": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainDocumentProcessingOptionsResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The processing options associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "progress": {
            "description": "The progress associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "serverId": {
            "description": "The server id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "serverName": {
            "description": "The server name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "stage": {
            "description": "The stage associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "targetServer": {
            "description": "The target server associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "targetServerId": {
            "description": "The target server id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "totalSections": {
            "description": "The total sections associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "attempt",
          "completedSections",
          "createdAt",
          "databaseName",
          "documentId",
          "fileName",
          "id",
          "maximumAttempts",
          "organizationId",
          "priority",
          "progress",
          "stage",
          "status",
          "totalSections",
          "updatedAt"
        ],
        "type": "object"
      },
      "DomainKnowledgeAdvancedConfigurationRequest": {
        "additionalProperties": false,
        "properties": {
          "topK": {
            "description": "The top k associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "topK"
        ],
        "type": "object"
      },
      "DomainKnowledgeConfigurationRequest": {
        "additionalProperties": false,
        "properties": {
          "advanced": {
            "$ref": "#/components/schemas/DomainKnowledgeAdvancedConfigurationRequest",
            "description": "The advanced associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "embeddingModel": {
            "$ref": "#/components/schemas/DomainEmbeddingModelConfigurationRequest",
            "description": "The embedding model associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "methodologies": {
            "description": "The methodologies associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/DomainMethodologyConfigurationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "processingModel": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainProcessingModelConfigurationRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The processing model associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "advanced",
          "embeddingModel",
          "methodologies"
        ],
        "type": "object"
      },
      "DomainMethodologyConfigurationRequest": {
        "additionalProperties": false,
        "properties": {
          "enabled": {
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "settings": {
            "$ref": "#/components/schemas/DomainMethodologySettingsRequest",
            "description": "The settings associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "enabled",
          "id"
        ],
        "type": "object"
      },
      "DomainMethodologySettingsRequest": {
        "additionalProperties": false,
        "properties": {
          "childChunkSize": {
            "description": "The child chunk size associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "chunkSize": {
            "description": "The chunk size associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "entityTypes": {
            "description": "The entity types associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "generationInstructions": {
            "description": "The generation instructions associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "overlap": {
            "description": "The overlap associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "parentChunkSize": {
            "description": "The parent chunk size associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "questionsPerSection": {
            "description": "The questions per section associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "summaryDetail": {
            "description": "The summary detail associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "DomainMethodologySettingsResponse": {
        "additionalProperties": false,
        "properties": {
          "childChunkSize": {
            "description": "The child chunk size associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "chunkSize": {
            "description": "The chunk size associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "entityTypes": {
            "description": "The entity types associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "generationInstructions": {
            "description": "The generation instructions associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "overlap": {
            "description": "The overlap associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "parentChunkSize": {
            "description": "The parent chunk size associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "questionsPerSection": {
            "description": "The questions per section associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "summaryDetail": {
            "description": "The summary detail associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "type": "object"
      },
      "DomainModelConnectionResponse": {
        "additionalProperties": false,
        "properties": {
          "baseUrl": {
            "description": "The base url associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "configuration": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "enabled": {
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "providerType": {
            "description": "The provider type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "configuration",
          "createdAt",
          "displayName",
          "enabled",
          "id",
          "organizationId",
          "providerType",
          "updatedAt"
        ],
        "type": "object"
      },
      "DomainModelDeploymentResponse": {
        "additionalProperties": false,
        "properties": {
          "capabilities": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "configuration": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "connectionId": {
            "description": "The connection id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "createdAt": {
            "description": "The UTC date and time when the resource was created.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "enabled": {
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "organizationId": {
            "description": "The organization id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "pinnedRevision": {
            "description": "The pinned revision associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "preload": {
            "description": "The preload associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "providerModelId": {
            "description": "The provider model id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "capabilities",
          "configuration",
          "connectionId",
          "createdAt",
          "displayName",
          "enabled",
          "id",
          "organizationId",
          "preload",
          "providerModelId",
          "updatedAt"
        ],
        "type": "object"
      },
      "DomainProcessingModelConfigurationRequest": {
        "additionalProperties": false,
        "properties": {
          "deploymentId": {
            "description": "The deployment id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "deploymentId"
        ],
        "type": "object"
      },
      "DomainTOCEntryResponse": {
        "additionalProperties": false,
        "properties": {
          "level": {
            "description": "The level associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "title": {
            "description": "The title associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "level",
          "title"
        ],
        "type": "object"
      },
      "HttpapiaccessExplanationSubjectResponse": {
        "additionalProperties": false,
        "properties": {
          "detail": {
            "description": "The detail associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "role": {
            "description": "The role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "name",
          "status",
          "type"
        ],
        "type": "object"
      },
      "HttpapiaccessResourceParentResponse": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resourceType": {
            "description": "The resource type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "id",
          "name",
          "resourceType"
        ],
        "type": "object"
      },
      "HttpapicheckAccessRequestRequest": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "The action associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "permission": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resourceId": {
            "description": "The resource id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resourceType": {
            "description": "The resource type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "subjectId": {
            "description": "The subject id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "subjectType": {
            "description": "The subject type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "action",
          "resourceId",
          "resourceType",
          "subjectId",
          "subjectType"
        ],
        "type": "object"
      },
      "HttpapicheckAccessResponseResponse": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "$ref": "#/components/schemas/HttpapieffectiveAccessActionResponse",
            "description": "The action associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resource": {
            "$ref": "#/components/schemas/HttpapieffectiveAccessResourceResponse",
            "description": "The resource associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "subject": {
            "$ref": "#/components/schemas/HttpapiaccessExplanationSubjectResponse",
            "description": "The subject associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "action",
          "resource",
          "subject"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessActionResponse": {
        "additionalProperties": false,
        "properties": {
          "allowed": {
            "description": "The allowed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "code": {
            "description": "A stable machine-readable code for the represented condition.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "message": {
            "description": "A human-readable explanation intended to help understand the result.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "reason": {
            "description": "The reason associated with this resource or operation.",
            "enum": [
              "explicit_deny",
              "inherited_access",
              "matching_allow",
              "no_matching_access",
              "platform_administrator",
              "role_and_grant",
              "role_permission",
              "system_owner"
            ],
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sources": {
            "description": "The sources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/HttpapieffectiveAccessSourceResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "allowed",
          "code",
          "description",
          "label",
          "message",
          "reason",
          "sources"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessPaginationResponse": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "The limit associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "offset": {
            "description": "The offset associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "total": {
            "description": "The total associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "limit",
          "offset",
          "total"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessRequestRequest": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "The limit associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "offset": {
            "description": "The offset associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "permission": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resourceType": {
            "description": "The resource type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "subjectId": {
            "description": "The subject id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "subjectType": {
            "description": "The subject type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "resourceType",
          "subjectId",
          "subjectType"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessResourceResponse": {
        "additionalProperties": false,
        "properties": {
          "actions": {
            "description": "The actions associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/HttpapieffectiveAccessActionResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "area": {
            "description": "The area associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "parent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HttpapiaccessResourceParentResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The parent associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resourceId": {
            "description": "The resource id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resourceType": {
            "description": "The resource type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "warning": {
            "description": "The warning associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "actions",
          "area",
          "name",
          "resourceId",
          "resourceType",
          "status"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessResourceTypeResponse": {
        "additionalProperties": false,
        "properties": {
          "area": {
            "description": "The area associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "code": {
            "description": "A stable machine-readable code for the represented condition.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "pluralLabel": {
            "description": "The plural label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "area",
          "code",
          "label",
          "pluralLabel"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessResponseResponse": {
        "additionalProperties": false,
        "properties": {
          "pageSummary": {
            "$ref": "#/components/schemas/HttpapieffectiveAccessSummaryResponse",
            "description": "The page summary associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "pagination": {
            "$ref": "#/components/schemas/HttpapieffectiveAccessPaginationResponse",
            "description": "The pagination associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resourceType": {
            "$ref": "#/components/schemas/HttpapieffectiveAccessResourceTypeResponse",
            "description": "The resource type associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resources": {
            "description": "The resources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/HttpapieffectiveAccessResourceResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "subject": {
            "$ref": "#/components/schemas/HttpapiaccessExplanationSubjectResponse",
            "description": "The subject associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "pageSummary",
          "pagination",
          "resourceType",
          "resources",
          "subject"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessSourceResponse": {
        "additionalProperties": false,
        "properties": {
          "actionMatch": {
            "description": "The action match associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "assignmentId": {
            "description": "The assignment id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "detail": {
            "description": "The detail associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "determinesResult": {
            "description": "The determines result associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "effect": {
            "description": "The effect associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "expiresAt": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The expires at associated with this resource or operation.",
            "example": "2026-08-28T00:00:00Z",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "inherited": {
            "description": "The inherited associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "overridden": {
            "description": "The overridden associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "relationship": {
            "description": "The relationship associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "resourceMatch": {
            "description": "The resource match associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "scope": {
            "description": "The scope associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sourceType": {
            "description": "The source type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "warning": {
            "description": "The warning associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "determinesResult",
          "effect",
          "inherited",
          "name",
          "overridden",
          "scope",
          "sourceType",
          "status"
        ],
        "type": "object"
      },
      "HttpapieffectiveAccessSummaryResponse": {
        "additionalProperties": false,
        "properties": {
          "allowedActions": {
            "description": "The allowed actions associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "explicitDenies": {
            "description": "The explicit denies associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "inactiveAssignments": {
            "description": "The inactive assignments associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "notAllowedActions": {
            "description": "The not allowed actions associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "allowedActions",
          "explicitDenies",
          "inactiveAssignments",
          "notAllowedActions"
        ],
        "type": "object"
      },
      "HttpapiworkflowRunViewResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DatabaseWorkflowRunRecordResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "approvalRequest": {
                "description": "The approval request associated with this resource or operation.",
                "example": "example-value",
                "type": "string",
                "x-punaha-access": "Inherits the operation access rules.",
                "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only in this response representation.",
                "x-punaha-presence": "optional",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
              }
            },
            "type": "object"
          }
        ]
      },
      "LlamacppCatalogueStatusResponse": {
        "additionalProperties": false,
        "properties": {
          "modelSizes": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "refreshing": {
            "description": "The refreshing associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "state": {
            "description": "The state associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "updatedAt": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The UTC date and time when the resource was last changed.",
            "example": "2026-08-28T00:00:00Z",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "refreshing",
          "state"
        ],
        "type": "object"
      },
      "ModelsChatResult": {
        "additionalProperties": false,
        "properties": {
          "message": {
            "$ref": "#/components/schemas/ModelsMessageResponse",
            "description": "Completed assistant message.",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "model": {
            "description": "Model identifier reported by the selected runtime or provider.",
            "example": "example-model",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "performance": {
            "additionalProperties": true,
            "description": "Optional runtime-specific performance measurements, available for local llama.cpp replies.",
            "type": "object",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "raw": {
            "description": "Optional original provider response as JSON. May contain provider-specific response details and should follow tenant data-handling rules.",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "usage": {
            "additionalProperties": true,
            "description": "Optional provider-specific token or usage measurements; field names and availability vary by provider.",
            "type": "object",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "model",
          "message"
        ],
        "type": "object"
      },
      "ModelsConnectionInputRequest": {
        "additionalProperties": false,
        "properties": {
          "baseUrl": {
            "description": "The base url associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "configuration": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "credentials": {
            "$ref": "#/components/schemas/ModelsProviderSecretRequest",
            "description": "The credentials associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "providerType": {
            "description": "The provider type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "baseUrl",
          "configuration",
          "credentials",
          "displayName",
          "providerType"
        ],
        "type": "object"
      },
      "ModelsDeploymentInputRequest": {
        "additionalProperties": false,
        "properties": {
          "capabilities": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "configuration": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "pinnedRevision": {
            "description": "The pinned revision associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "preload": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The preload associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "providerModelId": {
            "description": "The provider model id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "capabilities",
          "configuration",
          "displayName",
          "pinnedRevision",
          "providerModelId"
        ],
        "type": "object"
      },
      "ModelsMessageRequest": {
        "additionalProperties": false,
        "properties": {
          "content": {
            "description": "The content associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "role": {
            "description": "The role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "content",
          "role"
        ],
        "type": "object"
      },
      "ModelsMessageResponse": {
        "additionalProperties": false,
        "properties": {
          "content": {
            "description": "Complete generated message text.",
            "example": "Hello.",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "role": {
            "description": "Role of the message returned by the selected provider.",
            "example": "assistant",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "role",
          "content"
        ],
        "type": "object"
      },
      "ModelsProviderSecretRequest": {
        "additionalProperties": false,
        "properties": {
          "apiKey": {
            "description": "The api key associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "awsAccessKeyId": {
            "description": "The aws access key id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "awsSecretAccessKey": {
            "description": "The aws secret access key associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "awsSessionToken": {
            "description": "The aws session token associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "headers": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "Pagination": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "Maximum records requested for this page.",
            "example": 20,
            "minimum": 1,
            "type": "integer",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "offset": {
            "description": "Number of matching records skipped before this page.",
            "example": 0,
            "minimum": 0,
            "type": "integer",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "total": {
            "description": "Total matching records available at the time of the query.",
            "example": 42,
            "format": "int64",
            "minimum": 0,
            "type": "integer",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "total",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "VectorEmbeddingModelResponse": {
        "additionalProperties": false,
        "properties": {
          "available": {
            "description": "The available associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "contextTokens": {
            "description": "The context tokens associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "default": {
            "description": "The default associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "dimensions": {
            "description": "The dimensions associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "local": {
            "description": "The local associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "provider": {
            "description": "The provider associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "runtime": {
            "description": "The runtime associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "sizeBytes": {
            "description": "The size bytes associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "available",
          "default",
          "id",
          "local",
          "name",
          "provider",
          "runtime",
          "status"
        ],
        "type": "object"
      },
      "VectorMethodologyDefinitionResponse": {
        "additionalProperties": false,
        "properties": {
          "defaultSelected": {
            "description": "The default selected associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "defaultSettings": {
            "$ref": "#/components/schemas/DomainMethodologySettingsResponse",
            "description": "The default settings associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "enabled": {
            "description": "The enabled associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requiresProcessingModel": {
            "description": "The requires processing model associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "defaultSelected",
          "description",
          "enabled",
          "id",
          "name",
          "requiresProcessingModel"
        ],
        "type": "object"
      },
      "VectorSearchResultResponse": {
        "additionalProperties": false,
        "properties": {
          "content": {
            "description": "The content associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "distance": {
            "description": "The distance associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "documentId": {
            "description": "The document id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "metadata": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "score": {
            "description": "The score associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "title": {
            "description": "The title associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "content",
          "distance",
          "id",
          "metadata",
          "score"
        ],
        "type": "object"
      },
      "WorkflowBPMNActivityRequest": {
        "additionalProperties": false,
        "properties": {
          "cancelRemainingInstances": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The cancel remaining instances associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "completionCondition": {
            "description": "The completion condition associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "completionQuantity": {
            "description": "The completion quantity associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "defaultFlow": {
            "description": "The default flow associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "forCompensation": {
            "description": "The for compensation associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "loop": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNLoopCharacteristicsRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The loop associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "method": {
            "description": "The method associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "ordering": {
            "description": "The ordering associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "protocol": {
            "description": "The protocol associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "renderings": {
            "description": "The renderings associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "script": {
            "description": "The script associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "scriptFormat": {
            "description": "The script format associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "startQuantity": {
            "description": "The start quantity associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "WorkflowBPMNArtifactRequest": {
        "additionalProperties": false,
        "properties": {
          "associationDirection": {
            "description": "The association direction associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "categoryValueRef": {
            "description": "The category value ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "position": {
            "$ref": "#/components/schemas/WorkflowPositionRequest",
            "description": "The position associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targetRef": {
            "description": "The target ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "text": {
            "description": "The text associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "elementType",
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNBoundsRequest": {
        "additionalProperties": false,
        "properties": {
          "height": {
            "description": "The height associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "width": {
            "description": "The width associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "height",
          "width",
          "x",
          "y"
        ],
        "type": "object"
      },
      "WorkflowBPMNCategoryRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "values": {
            "description": "The values associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNCategoryValueRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNCategoryValueRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "value": {
            "description": "The value associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNChoreographyActivityRequest": {
        "additionalProperties": false,
        "properties": {
          "calledElementRef": {
            "description": "The called element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "children": {
            "description": "The children associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNChoreographyActivityRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "initiatingParticipantRef": {
            "description": "The initiating participant ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "loop": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNLoopCharacteristicsRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The loop associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messageFlowRefs": {
            "description": "The message flow refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "participantRefs": {
            "description": "The participant refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "elementType",
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNChoreographyRequest": {
        "additionalProperties": false,
        "properties": {
          "activities": {
            "description": "The activities associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNChoreographyActivityRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "artifacts": {
            "description": "The artifacts associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNArtifactRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "edges": {
            "description": "The edges associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowEdgeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "initiatingParticipantRef": {
            "description": "The initiating participant ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "participants": {
            "description": "The participants associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNParticipantRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNCollaborationRequest": {
        "additionalProperties": false,
        "properties": {
          "artifacts": {
            "description": "The artifacts associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNArtifactRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "closed": {
            "description": "The closed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "conversationLinks": {
            "description": "The conversation links associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowEdgeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "conversations": {
            "description": "The conversations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNConversationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "correlationKeys": {
            "description": "The correlation keys associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNCorrelationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messageFlows": {
            "description": "The message flows associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowEdgeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "participants": {
            "description": "The participants associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNParticipantRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNComplexBehaviorDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "condition": {
            "description": "The condition associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "eventDefinitions": {
            "description": "The event definitions associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNEventDefinitionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "condition"
        ],
        "type": "object"
      },
      "WorkflowBPMNConformanceClaimGateResponse": {
        "additionalProperties": false,
        "properties": {
          "blockers": {
            "description": "The blockers associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "complete": {
            "description": "The complete associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeReference": {
            "description": "The normative reference associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requiredEvidence": {
            "description": "The required evidence associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "blockers",
          "complete",
          "description",
          "id",
          "normativeReference",
          "requiredEvidence",
          "status"
        ],
        "type": "object"
      },
      "WorkflowBPMNConformanceFeatureResponse": {
        "additionalProperties": false,
        "properties": {
          "class": {
            "description": "The class associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "evidence": {
            "description": "The evidence associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "class",
          "description",
          "id",
          "status"
        ],
        "type": "object"
      },
      "WorkflowBPMNConformanceGateResponse": {
        "additionalProperties": false,
        "properties": {
          "blockers": {
            "description": "The blockers associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "complete": {
            "description": "The complete associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "blockers",
          "complete"
        ],
        "type": "object"
      },
      "WorkflowBPMNConformanceReportResponse": {
        "additionalProperties": false,
        "properties": {
          "claimGates": {
            "description": "The claim gates associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNConformanceClaimGateResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "claims": {
            "description": "The claims associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNConformanceFeatureResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeTests": {
            "description": "The normative tests associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNNormativeEvidenceResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "releaseEvidence": {
            "$ref": "#/components/schemas/WorkflowBPMNReleaseEvidenceResponse",
            "description": "The release evidence associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "releaseGate": {
            "$ref": "#/components/schemas/WorkflowBPMNConformanceGateResponse",
            "description": "The release gate associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requirements": {
            "description": "The requirements associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNConformanceRequirementResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "schemaSource": {
            "description": "The schema source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "selectedClaims": {
            "description": "The selected claims associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "standard": {
            "description": "The standard associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "summary": {
            "$ref": "#/components/schemas/WorkflowBPMNConformanceSummaryResponse",
            "description": "The summary associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "claimGates",
          "claims",
          "normativeTests",
          "releaseEvidence",
          "releaseGate",
          "requirements",
          "schemaSource",
          "selectedClaims",
          "standard",
          "summary",
          "version"
        ],
        "type": "object"
      },
      "WorkflowBPMNConformanceRequirementResponse": {
        "additionalProperties": false,
        "properties": {
          "capability": {
            "description": "The capability associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "class": {
            "description": "The class associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "evidence": {
            "description": "The evidence associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "limitation": {
            "description": "The limitation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeReference": {
            "description": "The normative reference associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "testObligations": {
            "description": "The test obligations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "capability",
          "class",
          "id",
          "normativeReference",
          "status",
          "testObligations"
        ],
        "type": "object"
      },
      "WorkflowBPMNConformanceSummaryResponse": {
        "additionalProperties": false,
        "properties": {
          "implemented": {
            "description": "The implemented associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "partial": {
            "description": "The partial associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "planned": {
            "description": "The planned associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "implemented",
          "partial",
          "planned"
        ],
        "type": "object"
      },
      "WorkflowBPMNConversationRequest": {
        "additionalProperties": false,
        "properties": {
          "calledElementRef": {
            "description": "The called element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "children": {
            "description": "The children associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNConversationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messageFlowRefs": {
            "description": "The message flow refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "participantRefs": {
            "description": "The participant refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNCorrelationRequest": {
        "additionalProperties": false,
        "properties": {
          "correlationPropertyRef": {
            "description": "The correlation property ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "retrievalExpressions": {
            "description": "The retrieval expressions associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNDataAssignmentRequest": {
        "additionalProperties": false,
        "properties": {
          "from": {
            "description": "The from associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "fromLanguage": {
            "description": "The from language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "to": {
            "description": "The to associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "toLanguage": {
            "description": "The to language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "from",
          "to"
        ],
        "type": "object"
      },
      "WorkflowBPMNDataAssociationRequest": {
        "additionalProperties": false,
        "properties": {
          "assignmentExpressions": {
            "description": "The assignment expressions associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataAssignmentRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "assignments": {
            "description": "The assignments associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sources": {
            "description": "The sources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "target": {
            "description": "The target associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "transformation": {
            "description": "The transformation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNDataElementRequest": {
        "additionalProperties": false,
        "properties": {
          "capacity": {
            "description": "The capacity associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "collection": {
            "description": "The collection associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataState": {
            "description": "The data state associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "itemSubjectRef": {
            "description": "The item subject ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "originalRef": {
            "description": "The original ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "unlimited": {
            "description": "The unlimited associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "elementType",
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "categories": {
            "description": "The categories associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNCategoryRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "choreographies": {
            "description": "The choreographies associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNChoreographyRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "collaborations": {
            "description": "The collaborations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNCollaborationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "conformanceProfile": {
            "description": "The conformance profile associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "conversations": {
            "description": "The conversations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNConversationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataStores": {
            "description": "The data stores associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "diagrams": {
            "description": "The diagrams associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDiagramRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "errors": {
            "description": "The errors associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNRootElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "escalations": {
            "description": "The escalations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNRootElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "exporter": {
            "description": "The exporter associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "exporterVersion": {
            "description": "The exporter version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "expressionLanguage": {
            "description": "The expression language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "extensionElementsXml": {
            "description": "The extension elements xml associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "imports": {
            "description": "The imports associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNImportRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "interfaces": {
            "description": "The interfaces associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNInterfaceRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "itemDefinitions": {
            "description": "The item definitions associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNItemDefinitionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messages": {
            "description": "The messages associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNRootElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "namespaces": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": "Example Namespaces",
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "primaryProcessId": {
            "description": "The primary process id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "processes": {
            "description": "The processes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNProcessRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "relationships": {
            "description": "The relationships associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNRelationshipRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resources": {
            "description": "The resources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNResourceRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "signals": {
            "description": "The signals associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNRootElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targetNamespace": {
            "description": "The target namespace associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "typeLanguage": {
            "description": "The type language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "WorkflowBPMNDiagramEdgeRequest": {
        "additionalProperties": false,
        "properties": {
          "elementRef": {
            "description": "The element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "label": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNLabelRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The label associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messageVisibleKind": {
            "description": "The message visible kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceElement": {
            "description": "The source element associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targetElement": {
            "description": "The target element associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waypoints": {
            "description": "The waypoints associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowPositionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "elementRef",
          "id",
          "waypoints"
        ],
        "type": "object"
      },
      "WorkflowBPMNDiagramRequest": {
        "additionalProperties": false,
        "properties": {
          "edges": {
            "description": "The edges associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDiagramEdgeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementRef": {
            "description": "The element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "labels": {
            "description": "The labels associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNLabelRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "orientation": {
            "description": "The orientation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "planeId": {
            "description": "The plane id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "shapes": {
            "description": "The shapes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNShapeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNElementRequest": {
        "additionalProperties": false,
        "properties": {
          "activationCondition": {
            "description": "The activation condition associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "activity": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNActivityRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The activity associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "attachedToRef": {
            "description": "The attached to ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "calledElement": {
            "description": "The called element associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "cancelActivity": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The cancel activity associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataAssociations": {
            "description": "The data associations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataAssociationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataInputs": {
            "description": "The data inputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataOutputs": {
            "description": "The data outputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "defaultFlow": {
            "description": "The default flow associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "documentation": {
            "description": "The documentation associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "eventDefinitions": {
            "description": "The event definitions associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNEventDefinitionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "eventGatewayType": {
            "description": "The event gateway type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "extensionXml": {
            "description": "The extension xml associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "gatewayDirection": {
            "description": "The gateway direction associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "implementation": {
            "description": "The implementation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "inputSets": {
            "description": "The input sets associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNInputSetRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "instantiate": {
            "description": "The instantiate associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "ioSpecificationId": {
            "description": "The io specification id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "isInterrupting": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The is interrupting associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "isTransaction": {
            "description": "The is transaction associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messageRef": {
            "description": "The message ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "operationRef": {
            "description": "The operation ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outputSets": {
            "description": "The output sets associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNOutputSetRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "parallelMultiple": {
            "description": "The parallel multiple associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "properties": {
            "description": "The properties associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNPropertyRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resources": {
            "description": "The resources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNResourceAssignmentRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "subProcess": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNProcessRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The sub process associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "transactionMethod": {
            "description": "The transaction method associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "triggeredByEvent": {
            "description": "The triggered by event associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "elementType"
        ],
        "type": "object"
      },
      "WorkflowBPMNEventDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "activityRef": {
            "description": "The activity ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "expression": {
            "description": "The expression associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "language": {
            "description": "The language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "operationRef": {
            "description": "The operation ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "reference": {
            "description": "The reference associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sources": {
            "description": "The sources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "target": {
            "description": "The target associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "timeCycle": {
            "description": "The time cycle associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "timeDate": {
            "description": "The time date associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "timeDuration": {
            "description": "The time duration associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waitForCompletion": {
            "description": "The wait for completion associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waitForCompletionSpecified": {
            "description": "The wait for completion specified associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "WorkflowBPMNFlowRequest": {
        "additionalProperties": false,
        "properties": {
          "assignments": {
            "description": "The assignments associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "associationDirection": {
            "description": "The association direction associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "conditionExpression": {
            "description": "The condition expression associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "conditionLanguage": {
            "description": "The condition language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "correlationKeyRefs": {
            "description": "The correlation key refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "isImmediate": {
            "description": "The is immediate associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messageRef": {
            "description": "The message ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "operationRef": {
            "description": "The operation ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "transformation": {
            "description": "The transformation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waypoints": {
            "description": "The waypoints associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowPositionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "WorkflowBPMNImportRequest": {
        "additionalProperties": false,
        "properties": {
          "importType": {
            "description": "The import type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "location": {
            "description": "The location associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "namespace": {
            "description": "The namespace associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "importType",
          "location",
          "namespace"
        ],
        "type": "object"
      },
      "WorkflowBPMNInputSetRequest": {
        "additionalProperties": false,
        "properties": {
          "dataInputRefs": {
            "description": "The data input refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "optionalInputRefs": {
            "description": "The optional input refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outputSetRefs": {
            "description": "The output set refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "whileExecutingInputRefs": {
            "description": "The while executing input refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNInterfaceRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "implementationRef": {
            "description": "The implementation ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "operations": {
            "description": "The operations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNOperationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNItemDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "isCollection": {
            "description": "The is collection associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "itemKind": {
            "description": "The item kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "structureRef": {
            "description": "The structure ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNLabelRequest": {
        "additionalProperties": false,
        "properties": {
          "bounds": {
            "$ref": "#/components/schemas/WorkflowBPMNBoundsRequest",
            "description": "The bounds associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "bounds"
        ],
        "type": "object"
      },
      "WorkflowBPMNLaneRequest": {
        "additionalProperties": false,
        "properties": {
          "childLaneSet": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNLaneSetRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The child lane set associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "flowNodeRefs": {
            "description": "The flow node refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "partitionElementRef": {
            "description": "The partition element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resources": {
            "description": "The resources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNResourceAssignmentRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNLaneSetRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "lanes": {
            "description": "The lanes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNLaneRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNLoopCharacteristicsRequest": {
        "additionalProperties": false,
        "properties": {
          "behavior": {
            "description": "The behavior associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "collection": {
            "description": "The collection associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "completionCondition": {
            "description": "The completion condition associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "complexBehaviorDefinitions": {
            "description": "The complex behavior definitions associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNComplexBehaviorDefinitionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementVariable": {
            "description": "The element variable associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "kind": {
            "description": "The kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "loopCondition": {
            "description": "The loop condition associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "loopMaximum": {
            "description": "The loop maximum associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "noneBehaviorEventRef": {
            "description": "The none behavior event ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "oneBehaviorEventRef": {
            "description": "The one behavior event ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sequential": {
            "description": "The sequential associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "testBefore": {
            "description": "The test before associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "kind"
        ],
        "type": "object"
      },
      "WorkflowBPMNNormativeEvidenceResponse": {
        "additionalProperties": false,
        "properties": {
          "behavior": {
            "description": "The behavior associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "claim": {
            "description": "The claim associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "evidence": {
            "description": "The evidence associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "limitation": {
            "description": "The limitation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeReference": {
            "description": "The normative reference associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requirementId": {
            "description": "The requirement id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "testModes": {
            "description": "The test modes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "behavior",
          "claim",
          "evidence",
          "id",
          "normativeReference",
          "requirementId",
          "status",
          "testModes"
        ],
        "type": "object"
      },
      "WorkflowBPMNOperationRequest": {
        "additionalProperties": false,
        "properties": {
          "errorRefs": {
            "description": "The error refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "implementationRef": {
            "description": "The implementation ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "inputMessageRef": {
            "description": "The input message ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outputMessageRef": {
            "description": "The output message ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNOutputSetRequest": {
        "additionalProperties": false,
        "properties": {
          "dataOutputRefs": {
            "description": "The data output refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "inputSetRefs": {
            "description": "The input set refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "optionalOutputRefs": {
            "description": "The optional output refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "whileExecutingOutputRefs": {
            "description": "The while executing output refs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNParticipantRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "multiplicityMaximum": {
            "description": "The multiplicity maximum associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "multiplicityMinimum": {
            "description": "The multiplicity minimum associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "partnerEntityRef": {
            "description": "The partner entity ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "partnerRoleRef": {
            "description": "The partner role ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "processRef": {
            "description": "The process ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNProcessRequest": {
        "additionalProperties": false,
        "properties": {
          "artifacts": {
            "description": "The artifacts associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNArtifactRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "auditingXml": {
            "description": "The auditing xml associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "closed": {
            "description": "The closed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "correlations": {
            "description": "The correlations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNCorrelationRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataInputs": {
            "description": "The data inputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataObjects": {
            "description": "The data objects associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataOutputs": {
            "description": "The data outputs associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dataStores": {
            "description": "The data stores associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNDataElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "documentation": {
            "description": "The documentation associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "edges": {
            "description": "The edges associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowEdgeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "executable": {
            "description": "The executable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "extensionXml": {
            "description": "The extension xml associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "inputSets": {
            "description": "The input sets associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNInputSetRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "ioSpecificationId": {
            "description": "The io specification id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "laneSets": {
            "description": "The lane sets associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNLaneSetRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "layout": {
            "$ref": "#/components/schemas/WorkflowLayoutRequest",
            "description": "The layout associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "monitoringXml": {
            "description": "The monitoring xml associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "nodes": {
            "description": "The nodes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowNodeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outputSets": {
            "description": "The output sets associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNOutputSetRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "processType": {
            "description": "The process type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "properties": {
            "description": "The properties associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNPropertyRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resources": {
            "description": "The resources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNResourceAssignmentRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "supports": {
            "description": "The supports associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNProfileDefinitionResponse": {
        "additionalProperties": false,
        "properties": {
          "dataAccessLanguage": {
            "description": "The data access language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "dataTypeLanguage": {
            "description": "The data type language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "elements": {
            "description": "The elements associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNProfileElementRequirementResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "serviceInterfaceLanguage": {
            "description": "The service interface language associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "standard": {
            "description": "The standard associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "dataAccessLanguage",
          "dataTypeLanguage",
          "description",
          "elements",
          "id",
          "serviceInterfaceLanguage",
          "standard",
          "version"
        ],
        "type": "object"
      },
      "WorkflowBPMNProfileElementRequirementResponse": {
        "additionalProperties": false,
        "properties": {
          "attributes": {
            "description": "The attributes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "element": {
            "description": "The element associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "evidence": {
            "description": "The evidence associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeReference": {
            "description": "The normative reference associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "notes": {
            "description": "The notes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "optionalAttributes": {
            "description": "The optional attributes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "testObligations": {
            "description": "The test obligations associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "variant": {
            "description": "The variant associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "element",
          "normativeReference",
          "status",
          "testObligations"
        ],
        "type": "object"
      },
      "WorkflowBPMNPropertyRequest": {
        "additionalProperties": false,
        "properties": {
          "dataState": {
            "description": "The data state associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "itemSubjectRef": {
            "description": "The item subject ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNRelationshipRequest": {
        "additionalProperties": false,
        "properties": {
          "direction": {
            "description": "The direction associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sources": {
            "description": "The sources associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targets": {
            "description": "The targets associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNReleaseEvidenceResponse": {
        "additionalProperties": false,
        "properties": {
          "externalToolInteroperability": {
            "description": "The external tool interoperability associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "fullMiwgCorpus": {
            "description": "The full miwg corpus associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "independentReview": {
            "description": "The independent review associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "externalToolInteroperability",
          "fullMiwgCorpus",
          "independentReview"
        ],
        "type": "object"
      },
      "WorkflowBPMNResourceAssignmentRequest": {
        "additionalProperties": false,
        "properties": {
          "assignmentExpression": {
            "description": "The assignment expression associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "resourceRef": {
            "description": "The resource ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "role": {
            "description": "The role associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "role"
        ],
        "type": "object"
      },
      "WorkflowBPMNResourceParameterRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "required": {
            "description": "The required associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNResourceRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "parameters": {
            "description": "The parameters associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowBPMNResourceParameterRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNRootElementRequest": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "description": "A stable machine-readable code for the represented condition.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "structureRef": {
            "description": "The structure ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "WorkflowBPMNShapeRequest": {
        "additionalProperties": false,
        "properties": {
          "bounds": {
            "$ref": "#/components/schemas/WorkflowBPMNBoundsRequest",
            "description": "The bounds associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "choreographyActivityShape": {
            "description": "The choreography activity shape associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementRef": {
            "description": "The element ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "expanded": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The expanded associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "horizontal": {
            "description": "The horizontal associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "label": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNLabelRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The label associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "markerVisible": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The marker visible associated with this resource or operation.",
            "example": true,
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "participantBandKind": {
            "description": "The participant band kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "bounds",
          "elementRef",
          "id"
        ],
        "type": "object"
      },
      "WorkflowChatAttachmentUploadRequest": {
        "additionalProperties": false,
        "properties": {
          "contentBase64": {
            "description": "The content base64 associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "contentType": {
            "description": "The content type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": true,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "fileName": {
            "description": "The file name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "contentBase64",
          "fileName"
        ],
        "type": "object"
      },
      "WorkflowCreateInputRequest": {
        "additionalProperties": false,
        "properties": {
          "definition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowDefinitionRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The definition associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "description": {
            "description": "The description associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "folderId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The folder id associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "slug": {
            "description": "The slug associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "description",
          "displayName",
          "slug"
        ],
        "type": "object"
      },
      "WorkflowDMNBoundsRequest": {
        "additionalProperties": false,
        "properties": {
          "height": {
            "description": "The height associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "width": {
            "description": "The width associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "x",
          "y"
        ],
        "type": "object"
      },
      "WorkflowDMNConformanceLevelResponse": {
        "additionalProperties": false,
        "properties": {
          "blockers": {
            "description": "The blockers associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "complete": {
            "description": "The complete associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "level": {
            "description": "The level associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeScope": {
            "description": "The normative scope associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requiredEvidence": {
            "description": "The required evidence associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "blockers",
          "complete",
          "level",
          "name",
          "normativeScope",
          "requiredEvidence"
        ],
        "type": "object"
      },
      "WorkflowDMNConformanceReportResponse": {
        "additionalProperties": false,
        "properties": {
          "levels": {
            "description": "The levels associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowDMNConformanceLevelResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeSource": {
            "description": "The normative source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "releaseEvidence": {
            "$ref": "#/components/schemas/WorkflowDMNReleaseEvidenceResponse",
            "description": "The release evidence associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "releaseGate": {
            "$ref": "#/components/schemas/WorkflowBPMNConformanceGateResponse",
            "description": "The release gate associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requestedLevel": {
            "description": "The requested level associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "requirements": {
            "description": "The requirements associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowDMNConformanceRequirementResponse"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "schemaSource": {
            "description": "The schema source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "standard": {
            "description": "The standard associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "summary": {
            "$ref": "#/components/schemas/WorkflowDMNConformanceSummaryResponse",
            "description": "The summary associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "levels",
          "normativeSource",
          "releaseEvidence",
          "releaseGate",
          "requestedLevel",
          "requirements",
          "schemaSource",
          "standard",
          "summary",
          "version"
        ],
        "type": "object"
      },
      "WorkflowDMNConformanceRequirementResponse": {
        "additionalProperties": false,
        "properties": {
          "capability": {
            "description": "The capability associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "evidence": {
            "description": "The evidence associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "limitation": {
            "description": "The limitation associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "normativeReference": {
            "description": "The normative reference associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "status": {
            "description": "The current lifecycle or processing state.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "capability",
          "id",
          "normativeReference",
          "status"
        ],
        "type": "object"
      },
      "WorkflowDMNConformanceSummaryResponse": {
        "additionalProperties": false,
        "properties": {
          "implemented": {
            "description": "The implemented associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "partial": {
            "description": "The partial associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "planned": {
            "description": "The planned associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "implemented",
          "partial",
          "planned"
        ],
        "type": "object"
      },
      "WorkflowDMNDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "elements": {
            "description": "The elements associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowDMNElementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "fileName": {
            "description": "The file name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "importedDocuments": {
            "description": "The imported documents associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowDMNDocumentRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "namespace": {
            "description": "The namespace associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "requirements": {
            "description": "The requirements associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowDMNRequirementRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceSha256": {
            "description": "The source sha256 associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceXml": {
            "description": "The source xml associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "namespace",
          "sourceSha256",
          "sourceXml",
          "version"
        ],
        "type": "object"
      },
      "WorkflowDMNDocumentRequest": {
        "additionalProperties": false,
        "properties": {
          "fileName": {
            "description": "The file name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "namespace": {
            "description": "The namespace associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceSha256": {
            "description": "The source sha256 associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceXml": {
            "description": "The source xml associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "fileName",
          "namespace",
          "sourceSha256",
          "sourceXml"
        ],
        "type": "object"
      },
      "WorkflowDMNElementRequest": {
        "additionalProperties": false,
        "properties": {
          "bounds": {
            "$ref": "#/components/schemas/WorkflowDMNBoundsRequest",
            "description": "The bounds associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "nodeId": {
            "description": "The node id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "typeRef": {
            "description": "The type ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "variableName": {
            "description": "The variable name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "nodeId",
          "type"
        ],
        "type": "object"
      },
      "WorkflowDMNLogicEditRequest": {
        "additionalProperties": false,
        "properties": {
          "edit": {
            "description": "A JSON value whose structure is defined by the selected operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementId": {
            "description": "The element id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementKind": {
            "description": "The element kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "kind": {
            "description": "The kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "edit",
          "elementId",
          "elementKind",
          "kind"
        ],
        "type": "object"
      },
      "WorkflowDMNLogicViewResponse": {
        "additionalProperties": false,
        "properties": {
          "edit": {
            "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "elementId": {
            "description": "The element id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "elementKind": {
            "description": "The element kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "kind": {
            "description": "The kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "simple": {
            "description": "The simple associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "visual": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DmnLogicVisualResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "The visual associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "edit",
          "elementId",
          "elementKind",
          "kind",
          "simple"
        ],
        "type": "object"
      },
      "WorkflowDMNReleaseEvidenceResponse": {
        "additionalProperties": false,
        "properties": {
          "externalInteroperability": {
            "description": "The external interoperability associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "fullTck": {
            "description": "The full tck associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "independentReview": {
            "description": "The independent review associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "externalInteroperability",
          "fullTck",
          "independentReview"
        ],
        "type": "object"
      },
      "WorkflowDMNRequirementRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceRef": {
            "description": "The source ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "targetRef": {
            "description": "The target ref associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "waypoints": {
            "description": "The waypoints associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowPositionRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "sourceRef",
          "targetRef",
          "type"
        ],
        "type": "object"
      },
      "WorkflowDefinitionRequest": {
        "additionalProperties": false,
        "properties": {
          "bpmn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNDefinitionRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The bpmn associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "dmn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowDMNDefinitionRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The dmn associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "edges": {
            "description": "The edges associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowEdgeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "imports": {
            "description": "The imports associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowStandardImportMetadataRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "layout": {
            "$ref": "#/components/schemas/WorkflowLayoutRequest",
            "description": "The layout associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "nodes": {
            "description": "The nodes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowNodeRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "protection": {
            "$ref": "#/components/schemas/WorkflowProtectionRequest",
            "description": "The protection associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "schemaVersion": {
            "description": "The schema version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "edges",
          "nodes",
          "schemaVersion"
        ],
        "type": "object"
      },
      "WorkflowEdgeRequest": {
        "additionalProperties": false,
        "properties": {
          "bpmn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNFlowRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The bpmn associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "branch": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The branch associated with this resource or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "condition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowTransitionConditionRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The condition associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "loop": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowLoopConfigurationRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The loop associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "source": {
            "description": "The source associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "target": {
            "description": "The target associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "source",
          "target"
        ],
        "type": "object"
      },
      "WorkflowEventData": {
        "additionalProperties": false,
        "properties": {
          "createdAt": {
            "description": "Time the event was stored.",
            "example": "2026-08-28T00:00:00Z",
            "format": "date-time",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "data": {
            "description": "Event type specific JSON values. Interpret them according to the event type.",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "id": {
            "description": "Stored event cursor.",
            "example": 78,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "nodeId": {
            "description": "Optional workflow node associated with this event.",
            "example": "example-node-id",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "runId": {
            "description": "Workflow run that owns this event.",
            "example": "example-run-id",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "type": {
            "description": "Workflow event type reported by the run.",
            "example": "run.completed",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "id",
          "runId",
          "type",
          "data",
          "createdAt"
        ],
        "type": "object"
      },
      "WorkflowEventFrame": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "contentMediaType": "application/json",
            "contentSchema": {
              "$ref": "#/components/schemas/WorkflowEventData"
            },
            "description": "JSON encoded stored event record. The numeric id inside this record matches the SSE id string.",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "event": {
            "const": "workflow.event",
            "description": "A stored workflow event.",
            "example": "workflow.event",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "id": {
            "description": "Numeric workflow event ID encoded as an SSE string. Supply it as the after query parameter on a deliberate reconnect.",
            "example": "78",
            "pattern": "^[0-9]+$",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "event",
          "id",
          "data"
        ],
        "type": "object"
      },
      "WorkflowImportItemRequest": {
        "additionalProperties": false,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementId": {
            "description": "The element id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "elementType": {
            "description": "The element type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "message": {
            "description": "A human-readable explanation intended to help understand the result.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "name": {
            "description": "The name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "outcome": {
            "description": "The outcome associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceId": {
            "description": "The source id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceKind": {
            "description": "The source kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "elementType",
          "message",
          "outcome"
        ],
        "type": "object"
      },
      "WorkflowLayoutNoteRequest": {
        "additionalProperties": false,
        "properties": {
          "collapsed": {
            "description": "The collapsed associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "text": {
            "description": "The text associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "id",
          "text",
          "x",
          "y"
        ],
        "type": "object"
      },
      "WorkflowLayoutRequest": {
        "additionalProperties": false,
        "properties": {
          "arrangementVersion": {
            "description": "The arrangement version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "collapsedGroups": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "nodes": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "notes": {
            "description": "The notes associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowLayoutNoteRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "WorkflowLoopConfigurationRequest": {
        "additionalProperties": false,
        "properties": {
          "carry": {
            "$ref": "#/components/schemas/WorkflowLoopStateConfigurationRequest",
            "description": "The carry associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "delaySeconds": {
            "description": "The delay seconds associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "maximumIterations": {
            "description": "The maximum iterations associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "onMaximum": {
            "$ref": "#/components/schemas/WorkflowMaximumIterationActionRequest",
            "description": "The on maximum associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "maximumIterations",
          "onMaximum"
        ],
        "type": "object"
      },
      "WorkflowLoopStateConfigurationRequest": {
        "additionalProperties": false,
        "properties": {
          "previousError": {
            "description": "The previous error associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "previousOutput": {
            "description": "The previous output associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "reviewerFeedback": {
            "description": "The reviewer feedback associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "validationFeedback": {
            "description": "The validation feedback associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "variables": {
            "description": "The variables associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "WorkflowMaximumIterationActionRequest": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "The action associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "target": {
            "description": "The target associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "WorkflowNodeRequest": {
        "additionalProperties": false,
        "properties": {
          "bpmn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowBPMNElementRequest"
              },
              {
                "type": "null"
              }
            ],
            "description": "The bpmn associated with this resource or operation.",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-nullable": true,
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "configuration": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "displayName": {
            "description": "The display name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "id": {
            "description": "The stable identifier of this resource.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "type": {
            "description": "The type associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "configuration",
          "displayName",
          "id",
          "type"
        ],
        "type": "object"
      },
      "WorkflowOverviewResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DatabaseWorkflowRecordResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "draftValid": {
                "description": "The draft valid associated with this resource or operation.",
                "example": true,
                "type": "boolean",
                "x-punaha-access": "Inherits the operation access rules.",
                "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only in this response representation.",
                "x-punaha-presence": "required",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
              },
              "lastRun": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/DatabaseWorkflowRunRecordResponse"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The last run associated with this resource or operation.",
                "x-punaha-access": "Inherits the operation access rules.",
                "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only in this response representation.",
                "x-punaha-nullable": true,
                "x-punaha-presence": "optional",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
              },
              "validationIssues": {
                "description": "The validation issues associated with this resource or operation.",
                "example": [
                  "example-value"
                ],
                "items": {
                  "$ref": "#/components/schemas/WorkflowValidationIssueResponse"
                },
                "type": "array",
                "x-punaha-access": "Inherits the operation access rules.",
                "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                "x-punaha-lifecycle": {
                  "deprecated": false,
                  "since": "Next Product release"
                },
                "x-punaha-mutability": "Read-only in this response representation.",
                "x-punaha-presence": "required",
                "x-punaha-sensitive": false,
                "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
              }
            },
            "required": [
              "draftValid",
              "validationIssues"
            ],
            "type": "object"
          }
        ]
      },
      "WorkflowPositionRequest": {
        "additionalProperties": false,
        "properties": {
          "x": {
            "description": "The x associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "y": {
            "description": "The y associated with this resource or operation.",
            "example": 1.5,
            "format": "double",
            "type": "number",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "x",
          "y"
        ],
        "type": "object"
      },
      "WorkflowProtectionRequest": {
        "additionalProperties": false,
        "properties": {
          "customChecks": {
            "description": "The custom checks associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "example": "example-value",
              "type": "string"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "preset": {
            "description": "The preset associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "customChecks",
          "preset"
        ],
        "type": "object"
      },
      "WorkflowRunInputRequest": {
        "additionalProperties": false,
        "properties": {
          "attachments": {
            "description": "The attachments associated with this resource or operation.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowChatAttachmentUploadRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "draftTest": {
            "description": "The draft test associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "messages": {
            "description": "The messages associated with this resource or operation.",
            "example": [
              {}
            ],
            "items": {
              "additionalProperties": true,
              "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
              "type": "object",
              "x-punaha-arbitrary": true
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "priority": {
            "description": "The priority associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "runKind": {
            "description": "The run kind associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "threadId": {
            "description": "The thread id associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "trigger": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "variables": {
            "additionalProperties": true,
            "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
            "example": {},
            "type": "object",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": 1,
            "format": "int64",
            "type": "integer",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "messages",
          "variables"
        ],
        "type": "object"
      },
      "WorkflowServerSentEvent": {
        "description": "Parsed workflow SSE frame. The event name selects the JSON schema used to decode the data string. Only workflow.event frames have an id cursor.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/WorkflowEventFrame"
          },
          {
            "$ref": "#/components/schemas/WorkflowSnapshotEvent"
          }
        ]
      },
      "WorkflowSnapshotEvent": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "contentMediaType": "application/json",
            "contentSchema": {
              "$ref": "#/components/schemas/HttpapiworkflowRunViewResponse"
            },
            "description": "JSON encoded direct workflow run representation. There is no ordinary data envelope, and this frame has no event ID.",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          },
          "event": {
            "const": "run.snapshot",
            "description": "A changed waiting or terminal run snapshot.",
            "example": "run.snapshot",
            "type": "string",
            "x-punaha-access": "Inherits the operation access boundary.",
            "x-punaha-availability": "Shared across documented Pūnaha HTTP operations.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "Omission, null, an empty value, zero, and false have distinct JSON meanings; only values permitted by this schema and the operation may be used.",
            "x-punaha-handling": "Do not copy customer content, credentials, or personal information into examples or unsupported logs.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only response value.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Generated by the Pūnaha HTTP boundary from the completed request or error."
          }
        },
        "required": [
          "event",
          "data"
        ],
        "type": "object"
      },
      "WorkflowStandardImportMetadataRequest": {
        "additionalProperties": false,
        "properties": {
          "executable": {
            "description": "The executable associated with this resource or operation.",
            "example": true,
            "type": "boolean",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "format": {
            "description": "The format associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "items": {
            "description": "The records included in this collection.",
            "example": [
              "example-value"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkflowImportItemRequest"
            },
            "type": "array",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceFileName": {
            "description": "The source file name associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "sourceSha256": {
            "description": "The source sha256 associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "version": {
            "description": "The version associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "required": [
          "executable",
          "format",
          "sourceFileName",
          "sourceSha256"
        ],
        "type": "object"
      },
      "WorkflowTransitionConditionRequest": {
        "additionalProperties": false,
        "properties": {
          "label": {
            "description": "The label associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "left": {
            "description": "The left associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "on": {
            "description": "The on associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "operator": {
            "description": "The operator associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          },
          "value": {
            "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
            "example": "example-value",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-arbitrary": true,
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
            "x-punaha-presence": "optional",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Provided by the caller and validated by Pūnaha."
          }
        },
        "type": "object"
      },
      "WorkflowValidationIssueResponse": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "description": "A stable machine-readable code for the represented condition.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "message": {
            "description": "A human-readable explanation intended to help understand the result.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          },
          "path": {
            "description": "The path associated with this resource or operation.",
            "example": "example-value",
            "type": "string",
            "x-punaha-access": "Inherits the operation access rules.",
            "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
            "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
            "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
            "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
            "x-punaha-lifecycle": {
              "deprecated": false,
              "since": "Next Product release"
            },
            "x-punaha-mutability": "Read-only in this response representation.",
            "x-punaha-presence": "required",
            "x-punaha-sensitive": false,
            "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
          }
        },
        "required": [
          "code",
          "message",
          "path"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "bearerFormat": "Pūnaha session token",
        "description": "A Pūnaha-issued session token. Supported actor and token lifecycle rules are operation-specific.",
        "scheme": "bearer",
        "type": "http"
      },
      "serviceToken": {
        "bearerFormat": "private service token",
        "description": "Private service-role authentication. This mechanism is not part of the customer integration surface.",
        "scheme": "bearer",
        "type": "http"
      },
      "sessionCookie": {
        "description": "Short-lived authenticated Pūnaha browser session. Do not treat a browser cookie as a durable integration credential.",
        "in": "cookie",
        "name": "punaha_session",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "description": "The API available from this Pūnaha installation. Request and response fields come from the Product code used to build this version. This view contains operations intended for customer integrations. Preview operations may change. Product-only, setup, and private-service routes are not shown. Enabled service roles: core, vector, workflow, inference, frontend.",
    "license": {
      "identifier": "LicenseRef-Punaha-Product",
      "name": "Pūnaha product licence"
    },
    "summary": "Pūnaha HTTP API contract",
    "title": "Pūnaha API",
    "version": "1.0.0"
  },
  "openapi": "3.2.0",
  "paths": {
    "/api/authorization/check-access": {
      "post": {
        "description": "### Purpose\nCheck Access authorization. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiAuthorizationCheckAccess",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "action": "example-value",
                    "permission": "example-value",
                    "resourceId": "example-value",
                    "resourceType": "example-value",
                    "subjectId": "example-value",
                    "subjectType": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "action": "example-value",
                    "resourceId": "example-value",
                    "resourceType": "example-value",
                    "subjectId": "example-value",
                    "subjectType": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/HttpapicheckAccessRequestRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "action": {
                          "allowed": true,
                          "code": "example-value",
                          "description": "example-value",
                          "label": "example-value",
                          "message": "example-value",
                          "reason": "example-value",
                          "sources": [
                            {
                              "actionMatch": "example-value",
                              "assignmentId": "example-value",
                              "detail": "example-value",
                              "determinesResult": true,
                              "effect": "example-value",
                              "expiresAt": "2026-08-28T00:00:00Z",
                              "inherited": true,
                              "name": "example-value",
                              "overridden": true,
                              "relationship": "example-value",
                              "resourceMatch": "example-value",
                              "scope": "example-value",
                              "sourceType": "example-value",
                              "status": "example-value",
                              "warning": "example-value"
                            }
                          ]
                        },
                        "resource": {
                          "actions": [
                            {
                              "allowed": true,
                              "code": "example-value",
                              "description": "example-value",
                              "label": "example-value",
                              "message": "example-value",
                              "reason": "example-value",
                              "sources": [
                                {
                                  "actionMatch": "example-value",
                                  "assignmentId": "example-value",
                                  "detail": "example-value",
                                  "determinesResult": true,
                                  "effect": "example-value",
                                  "expiresAt": "2026-08-28T00:00:00Z",
                                  "inherited": true,
                                  "name": "example-value",
                                  "overridden": true,
                                  "relationship": "example-value",
                                  "resourceMatch": "example-value",
                                  "scope": "example-value",
                                  "sourceType": "example-value",
                                  "status": "example-value",
                                  "warning": "example-value"
                                }
                              ]
                            }
                          ],
                          "area": "example-value",
                          "description": "example-value",
                          "name": "example-value",
                          "parent": {
                            "id": "example-value",
                            "name": "example-value",
                            "resourceType": "example-value"
                          },
                          "resourceId": "example-value",
                          "resourceType": "example-value",
                          "status": "example-value",
                          "warning": "example-value"
                        },
                        "subject": {
                          "detail": "example-value",
                          "id": "example-value",
                          "name": "example-value",
                          "role": "example-value",
                          "status": "example-value",
                          "type": "example-value"
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/HttpapicheckAccessResponseResponse",
                      "description": "The operation-specific result.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "access-action-unsupported": {
                    "summary": "Choose an action available for this resource type.",
                    "value": {
                      "error": {
                        "code": "ACCESS_ACTION_UNSUPPORTED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Choose an action available for this resource type."
                      }
                    }
                  },
                  "access-resource-required": {
                    "summary": "Choose a resource to check.",
                    "value": {
                      "error": {
                        "code": "ACCESS_RESOURCE_REQUIRED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Choose a resource to check."
                      }
                    }
                  },
                  "access-resource-type-unsupported": {
                    "summary": "Choose a resource type from the permission catalogue.",
                    "value": {
                      "error": {
                        "code": "ACCESS_RESOURCE_TYPE_UNSUPPORTED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Choose a resource type from the permission catalogue."
                      }
                    }
                  },
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "access-resource-not-available": {
                    "summary": "That resource is unavailable or outside your access-management scope.",
                    "value": {
                      "error": {
                        "code": "ACCESS_RESOURCE_NOT_AVAILABLE",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "That resource is unavailable or outside your access-management scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Check Access authorization",
        "tags": [
          "Access and identity"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [],
          "resourceAction": "",
          "resourceScope": "",
          "resourceType": "",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "effective_access.go:121",
          "owner": "Access and identity",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "core"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "authorization.access.checked"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "Choose an action available for this resource type.",
            "code": "ACCESS_ACTION_UNSUPPORTED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "Choose a resource to check.",
            "code": "ACCESS_RESOURCE_REQUIRED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "Choose a resource type from the permission catalogue.",
            "code": "ACCESS_RESOURCE_TYPE_UNSUPPORTED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "That resource is unavailable or outside your access-management scope.",
            "code": "ACCESS_RESOURCE_NOT_AVAILABLE",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "action": "example-value",
                "permission": "example-value",
                "resourceId": "example-value",
                "resourceType": "example-value",
                "subjectId": "example-value",
                "subjectType": "example-value"
              },
              "method": "POST",
              "path": "/api/authorization/check-access"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "action": "example-value",
                "permission": "example-value",
                "resourceId": "example-value",
                "resourceType": "example-value",
                "subjectId": "example-value",
                "subjectType": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/authorization/check-access"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/authorization/check-access"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Check Access authorization. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "postapiAuthorizationEffectiveAccess",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/authorization/effective-access": {
      "post": {
        "description": "### Purpose\nEffective Access authorization. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiAuthorizationEffectiveAccess",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "limit": 1,
                    "offset": 1,
                    "permission": "example-value",
                    "resourceType": "example-value",
                    "subjectId": "example-value",
                    "subjectType": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "resourceType": "example-value",
                    "subjectId": "example-value",
                    "subjectType": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/HttpapieffectiveAccessRequestRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "pageSummary": {
                          "allowedActions": 1,
                          "explicitDenies": 1,
                          "inactiveAssignments": 1,
                          "notAllowedActions": 1
                        },
                        "pagination": {
                          "limit": 1,
                          "offset": 1,
                          "total": 1
                        },
                        "resourceType": {
                          "area": "example-value",
                          "code": "example-value",
                          "label": "example-value",
                          "pluralLabel": "example-value"
                        },
                        "resources": [
                          {
                            "actions": [
                              {
                                "allowed": true,
                                "code": "example-value",
                                "description": "example-value",
                                "label": "example-value",
                                "message": "example-value",
                                "reason": "example-value",
                                "sources": [
                                  {
                                    "actionMatch": "example-value",
                                    "assignmentId": "example-value",
                                    "detail": "example-value",
                                    "determinesResult": true,
                                    "effect": "example-value",
                                    "expiresAt": "2026-08-28T00:00:00Z",
                                    "inherited": true,
                                    "name": "example-value",
                                    "overridden": true,
                                    "relationship": "example-value",
                                    "resourceMatch": "example-value",
                                    "scope": "example-value",
                                    "sourceType": "example-value",
                                    "status": "example-value",
                                    "warning": "example-value"
                                  }
                                ]
                              }
                            ],
                            "area": "example-value",
                            "description": "example-value",
                            "name": "example-value",
                            "parent": {
                              "id": "example-value",
                              "name": "example-value",
                              "resourceType": "example-value"
                            },
                            "resourceId": "example-value",
                            "resourceType": "example-value",
                            "status": "example-value",
                            "warning": "example-value"
                          }
                        ],
                        "subject": {
                          "detail": "example-value",
                          "id": "example-value",
                          "name": "example-value",
                          "role": "example-value",
                          "status": "example-value",
                          "type": "example-value"
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/HttpapieffectiveAccessResponseResponse",
                      "description": "The operation-specific result.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "access-resource-type-unsupported": {
                    "summary": "Choose a resource type from the permission catalogue.",
                    "value": {
                      "error": {
                        "code": "ACCESS_RESOURCE_TYPE_UNSUPPORTED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Choose a resource type from the permission catalogue."
                      }
                    }
                  },
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Effective Access authorization",
        "tags": [
          "Access and identity"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [],
          "resourceAction": "",
          "resourceScope": "",
          "resourceType": "",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "effective_access.go:120",
          "owner": "Access and identity",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "core"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "Choose a resource type from the permission catalogue.",
            "code": "ACCESS_RESOURCE_TYPE_UNSUPPORTED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "limit": 1,
                "offset": 1,
                "permission": "example-value",
                "resourceType": "example-value",
                "subjectId": "example-value",
                "subjectType": "example-value"
              },
              "method": "POST",
              "path": "/api/authorization/effective-access"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "limit": 1,
                "offset": 1,
                "permission": "example-value",
                "resourceType": "example-value",
                "subjectId": "example-value",
                "subjectType": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/authorization/effective-access"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/authorization/effective-access"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Effective Access authorization. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "postapiAuthorizationCheckAccess",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/case-events": {
      "post": {
        "description": "### Purpose\nCreate case events. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiCaseEvents",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "correlationKey": "example-value",
                    "eventType": "example-value",
                    "idempotencyKey": "example-value",
                    "payload": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "correlationKey": "example-value",
                    "eventType": "example-value",
                    "idempotencyKey": "example-value",
                    "payload": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/CaseworkCorrelatedEventInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "caseIds": [
                          "example-value"
                        ],
                        "event": {
                          "consumedByCaseId": "example-value",
                          "correlationKey": "example-value",
                          "eventType": "example-value",
                          "id": "example-value",
                          "idempotencyKey": "example-value",
                          "organizationId": "example-value",
                          "payload": "example-value",
                          "receivedAt": "2026-08-28T00:00:00Z",
                          "receivedBy": "example-value"
                        },
                        "workflowRunIds": [
                          "example-value"
                        ]
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "caseIds": {
                          "description": "The case ids associated with this resource or operation.",
                          "example": [
                            "example-value"
                          ],
                          "items": {
                            "example": "example-value",
                            "type": "string"
                          },
                          "type": "array",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "event": {
                          "$ref": "#/components/schemas/DatabaseCaseCorrelatedEventRecordResponse",
                          "description": "The event associated with this resource or operation.",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "workflowRunIds": {
                          "description": "The workflow run ids associated with this resource or operation.",
                          "example": [
                            "example-value"
                          ],
                          "items": {
                            "example": "example-value",
                            "type": "string"
                          },
                          "type": "array",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "caseIds",
                        "event",
                        "workflowRunIds"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The request was accepted for background processing; use the documented status operation to monitor it.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create case events",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.work"
          ],
          "resourceAction": "create",
          "resourceScope": "*",
          "resourceType": "case",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:289",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "case.event_received"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "correlationKey": "example-value",
                "eventType": "example-value",
                "idempotencyKey": "example-value",
                "payload": "example-value"
              },
              "method": "POST",
              "path": "/api/case-events"
            },
            "response": {
              "status": "202"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "correlationKey": "example-value",
                "eventType": "example-value",
                "idempotencyKey": "example-value",
                "payload": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/case-events"
            },
            "response": {
              "status": "202"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/case-events"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Create case events. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/case-types": {
      "get": {
        "description": "### Purpose\nList case types. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiCaseTypes",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:33",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/case-types"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/case-types"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/case-types"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List case types. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiCaseEvents",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "post": {
        "description": "### Purpose\nCreate case types. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiCaseTypes",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "definition": {
                      "artifacts": [
                        {
                          "direction": "example-value",
                          "id": "example-value",
                          "sourceRef": "example-value",
                          "targetRef": "example-value",
                          "text": "example-value",
                          "textFormat": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "caseFile": [
                        {
                          "definitionRef": "example-value",
                          "definitionType": "example-value",
                          "id": "example-value",
                          "multiplicity": "example-value",
                          "name": "example-value",
                          "parentId": "example-value",
                          "properties": [
                            {
                              "id": "example-value",
                              "name": "example-value",
                              "type": "example-value"
                            }
                          ],
                          "sourceRef": "example-value",
                          "structureRef": "example-value",
                          "targetRefs": [
                            "example-value"
                          ]
                        }
                      ],
                      "diagram": {
                        "edges": [
                          {
                            "elementRef": "example-value",
                            "id": "example-value",
                            "sourceRef": "example-value",
                            "standardEventVisible": true,
                            "targetRef": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          }
                        ],
                        "height": 1.5,
                        "id": "example-value",
                        "name": "example-value",
                        "shapes": [
                          {
                            "collapsed": true,
                            "elementRef": "example-value",
                            "height": 1.5,
                            "id": "example-value",
                            "planningTableCollapsed": true,
                            "width": 1.5,
                            "x": 1.5,
                            "y": 1.5
                          }
                        ],
                        "width": 1.5
                      },
                      "fields": [
                        {
                          "description": "example-value",
                          "id": "example-value",
                          "label": "example-value",
                          "maximum": 1.5,
                          "minimum": 1.5,
                          "options": [
                            "example-value"
                          ],
                          "requiredAtStart": true,
                          "sensitive": true,
                          "type": "example-value"
                        }
                      ],
                      "format": "example-value",
                      "outcomes": [
                        "example-value"
                      ],
                      "policies": {
                        "allowReopen": true,
                        "classification": "example-value",
                        "completionMode": "example-value",
                        "retentionDays": 1
                      },
                      "purpose": "example-value",
                      "requirements": [
                        {
                          "appliesWhen": {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          },
                          "blocksCompletion": true,
                          "description": "example-value",
                          "due": {
                            "amount": 1,
                            "from": "example-value",
                            "unit": "example-value"
                          },
                          "enforcement": "example-value",
                          "fieldId": "example-value",
                          "id": "example-value",
                          "milestoneId": "example-value",
                          "name": "example-value",
                          "planItemId": "example-value",
                          "responsibleRole": "example-value",
                          "stageId": "example-value",
                          "type": "example-value",
                          "waivable": true,
                          "waiverRole": "example-value"
                        }
                      ],
                      "roles": [
                        {
                          "description": "example-value",
                          "id": "example-value",
                          "name": "example-value"
                        }
                      ],
                      "schemaVersion": 1,
                      "sentries": [
                        {
                          "id": "example-value",
                          "ifPart": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "name": "example-value",
                          "onParts": [
                            {
                              "exitCriterionRef": "example-value",
                              "id": "example-value",
                              "sourceRef": "example-value",
                              "sourceType": "example-value",
                              "standardEvent": "example-value"
                            }
                          ]
                        }
                      ],
                      "stages": [
                        {
                          "autoComplete": true,
                          "control": {
                            "manualActivation": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            },
                            "repetition": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            },
                            "required": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            }
                          },
                          "description": "example-value",
                          "entryCriteria": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "entrySentryRefs": [
                            "example-value"
                          ],
                          "exitCriteria": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "exitSentryRefs": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "items": [
                            {
                              "authorizedRoles": [
                                "example-value"
                              ],
                              "blocking": true,
                              "caseTypeId": "example-value",
                              "caseTypeVersion": 1,
                              "children": [
                                {}
                              ],
                              "control": {
                                "manualActivation": {
                                  "condition": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "sentryRef": "example-value"
                                },
                                "repetition": {
                                  "condition": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "sentryRef": "example-value"
                                },
                                "required": {
                                  "condition": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "sentryRef": "example-value"
                                }
                              },
                              "correlationField": "example-value",
                              "decision": {
                                "hitPolicy": "example-value",
                                "id": "example-value",
                                "inputs": [
                                  {
                                    "id": "example-value",
                                    "label": "example-value"
                                  }
                                ],
                                "name": "example-value",
                                "outputs": [
                                  {
                                    "id": "example-value",
                                    "label": "example-value"
                                  }
                                ],
                                "rules": [
                                  {
                                    "conditions": {},
                                    "id": "example-value",
                                    "outputs": {}
                                  }
                                ]
                              },
                              "definitionRef": "example-value",
                              "description": "example-value",
                              "due": {
                                "amount": 1,
                                "from": "example-value",
                                "unit": "example-value"
                              },
                              "entryCriteria": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "entrySentryRefs": [
                                "example-value"
                              ],
                              "eventType": "example-value",
                              "exitCriteria": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "exitSentryRefs": [
                                "example-value"
                              ],
                              "externalImportType": "example-value",
                              "externalLocation": "example-value",
                              "externalNamespace": "example-value",
                              "externalPrefix": "example-value",
                              "externalRef": "example-value",
                              "id": "example-value",
                              "implementationType": "example-value",
                              "input": {},
                              "inputMappings": [
                                {
                                  "id": "example-value",
                                  "source": "example-value",
                                  "target": "example-value",
                                  "transformation": "example-value"
                                }
                              ],
                              "manualActivation": true,
                              "name": "example-value",
                              "outputMappings": [
                                {
                                  "id": "example-value",
                                  "source": "example-value",
                                  "target": "example-value",
                                  "transformation": "example-value"
                                }
                              ],
                              "planningTable": {
                                "applicabilityRules": [
                                  {
                                    "expressionLanguage": "example-value",
                                    "operator": "example-value",
                                    "source": "example-value",
                                    "value": "example-value"
                                  }
                                ],
                                "authorizedRoles": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "itemRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "tables": [
                                  {}
                                ]
                              },
                              "repeatable": true,
                              "required": true,
                              "roleId": "example-value",
                              "timeoutMinutes": 1,
                              "timerExpression": "example-value",
                              "timerStart": {
                                "exitCriterionRef": "example-value",
                                "id": "example-value",
                                "sourceRef": "example-value",
                                "sourceType": "example-value",
                                "standardEvent": "example-value"
                              },
                              "type": "example-value",
                              "workflowId": "example-value",
                              "workflowVersion": 1
                            }
                          ],
                          "manualActivation": true,
                          "name": "example-value",
                          "parentId": "example-value",
                          "planningTable": {
                            "applicabilityRules": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "authorizedRoles": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "itemRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "tables": [
                              {}
                            ]
                          },
                          "repeatable": true,
                          "required": true
                        }
                      ]
                    },
                    "description": "example-value",
                    "displayName": "example-value",
                    "slug": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "description": "example-value",
                    "displayName": "example-value",
                    "slug": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/CaseworkCreateTypeInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:51",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "case_type.created"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "definition": {
                  "artifacts": [
                    {
                      "direction": "example-value",
                      "id": "example-value",
                      "sourceRef": "example-value",
                      "targetRef": "example-value",
                      "text": "example-value",
                      "textFormat": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "caseFile": [
                    {
                      "definitionRef": "example-value",
                      "definitionType": "example-value",
                      "id": "example-value",
                      "multiplicity": "example-value",
                      "name": "example-value",
                      "parentId": "example-value",
                      "properties": [
                        {
                          "id": "example-value",
                          "name": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "sourceRef": "example-value",
                      "structureRef": "example-value",
                      "targetRefs": [
                        "example-value"
                      ]
                    }
                  ],
                  "diagram": {
                    "edges": [
                      {
                        "elementRef": "example-value",
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "standardEventVisible": true,
                        "targetRef": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      }
                    ],
                    "height": 1.5,
                    "id": "example-value",
                    "name": "example-value",
                    "shapes": [
                      {
                        "collapsed": true,
                        "elementRef": "example-value",
                        "height": 1.5,
                        "id": "example-value",
                        "planningTableCollapsed": true,
                        "width": 1.5,
                        "x": 1.5,
                        "y": 1.5
                      }
                    ],
                    "width": 1.5
                  },
                  "fields": [
                    {
                      "description": "example-value",
                      "id": "example-value",
                      "label": "example-value",
                      "maximum": 1.5,
                      "minimum": 1.5,
                      "options": [
                        "example-value"
                      ],
                      "requiredAtStart": true,
                      "sensitive": true,
                      "type": "example-value"
                    }
                  ],
                  "format": "example-value",
                  "outcomes": [
                    "example-value"
                  ],
                  "policies": {
                    "allowReopen": true,
                    "classification": "example-value",
                    "completionMode": "example-value",
                    "retentionDays": 1
                  },
                  "purpose": "example-value",
                  "requirements": [
                    {
                      "appliesWhen": {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      },
                      "blocksCompletion": true,
                      "description": "example-value",
                      "due": {
                        "amount": 1,
                        "from": "example-value",
                        "unit": "example-value"
                      },
                      "enforcement": "example-value",
                      "fieldId": "example-value",
                      "id": "example-value",
                      "milestoneId": "example-value",
                      "name": "example-value",
                      "planItemId": "example-value",
                      "responsibleRole": "example-value",
                      "stageId": "example-value",
                      "type": "example-value",
                      "waivable": true,
                      "waiverRole": "example-value"
                    }
                  ],
                  "roles": [
                    {
                      "description": "example-value",
                      "id": "example-value",
                      "name": "example-value"
                    }
                  ],
                  "schemaVersion": 1,
                  "sentries": [
                    {
                      "id": "example-value",
                      "ifPart": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "name": "example-value",
                      "onParts": [
                        {
                          "exitCriterionRef": "example-value",
                          "id": "example-value",
                          "sourceRef": "example-value",
                          "sourceType": "example-value",
                          "standardEvent": "example-value"
                        }
                      ]
                    }
                  ],
                  "stages": [
                    {
                      "autoComplete": true,
                      "control": {
                        "manualActivation": {
                          "condition": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "sentryRef": "example-value"
                        },
                        "repetition": {
                          "condition": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "sentryRef": "example-value"
                        },
                        "required": {
                          "condition": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "sentryRef": "example-value"
                        }
                      },
                      "description": "example-value",
                      "entryCriteria": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "entrySentryRefs": [
                        "example-value"
                      ],
                      "exitCriteria": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "exitSentryRefs": [
                        "example-value"
                      ],
                      "id": "example-value",
                      "items": [
                        {
                          "authorizedRoles": [
                            "example-value"
                          ],
                          "blocking": true,
                          "caseTypeId": "example-value",
                          "caseTypeVersion": 1,
                          "children": [
                            {}
                          ],
                          "control": {
                            "manualActivation": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            },
                            "repetition": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            },
                            "required": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            }
                          },
                          "correlationField": "example-value",
                          "decision": {
                            "hitPolicy": "example-value",
                            "id": "example-value",
                            "inputs": [
                              {
                                "id": "example-value",
                                "label": "example-value"
                              }
                            ],
                            "name": "example-value",
                            "outputs": [
                              {
                                "id": "example-value",
                                "label": "example-value"
                              }
                            ],
                            "rules": [
                              {
                                "conditions": {},
                                "id": "example-value",
                                "outputs": {}
                              }
                            ]
                          },
                          "definitionRef": "example-value",
                          "description": "example-value",
                          "due": {
                            "amount": 1,
                            "from": "example-value",
                            "unit": "example-value"
                          },
                          "entryCriteria": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "entrySentryRefs": [
                            "example-value"
                          ],
                          "eventType": "example-value",
                          "exitCriteria": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "exitSentryRefs": [
                            "example-value"
                          ],
                          "externalImportType": "example-value",
                          "externalLocation": "example-value",
                          "externalNamespace": "example-value",
                          "externalPrefix": "example-value",
                          "externalRef": "example-value",
                          "id": "example-value",
                          "implementationType": "example-value",
                          "input": {},
                          "inputMappings": [
                            {
                              "id": "example-value",
                              "source": "example-value",
                              "target": "example-value",
                              "transformation": "example-value"
                            }
                          ],
                          "manualActivation": true,
                          "name": "example-value",
                          "outputMappings": [
                            {
                              "id": "example-value",
                              "source": "example-value",
                              "target": "example-value",
                              "transformation": "example-value"
                            }
                          ],
                          "planningTable": {
                            "applicabilityRules": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "authorizedRoles": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "itemRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "tables": [
                              {}
                            ]
                          },
                          "repeatable": true,
                          "required": true,
                          "roleId": "example-value",
                          "timeoutMinutes": 1,
                          "timerExpression": "example-value",
                          "timerStart": {
                            "exitCriterionRef": "example-value",
                            "id": "example-value",
                            "sourceRef": "example-value",
                            "sourceType": "example-value",
                            "standardEvent": "example-value"
                          },
                          "type": "example-value",
                          "workflowId": "example-value",
                          "workflowVersion": 1
                        }
                      ],
                      "manualActivation": true,
                      "name": "example-value",
                      "parentId": "example-value",
                      "planningTable": {
                        "applicabilityRules": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "authorizedRoles": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "itemRefs": [
                          "example-value"
                        ],
                        "name": "example-value",
                        "tables": [
                          {}
                        ]
                      },
                      "repeatable": true,
                      "required": true
                    }
                  ]
                },
                "description": "example-value",
                "displayName": "example-value",
                "slug": "example-value"
              },
              "method": "POST",
              "path": "/api/case-types"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "definition": {
                  "artifacts": [
                    {
                      "direction": "example-value",
                      "id": "example-value",
                      "sourceRef": "example-value",
                      "targetRef": "example-value",
                      "text": "example-value",
                      "textFormat": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "caseFile": [
                    {
                      "definitionRef": "example-value",
                      "definitionType": "example-value",
                      "id": "example-value",
                      "multiplicity": "example-value",
                      "name": "example-value",
                      "parentId": "example-value",
                      "properties": [
                        {
                          "id": "example-value",
                          "name": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "sourceRef": "example-value",
                      "structureRef": "example-value",
                      "targetRefs": [
                        "example-value"
                      ]
                    }
                  ],
                  "diagram": {
                    "edges": [
                      {
                        "elementRef": "example-value",
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "standardEventVisible": true,
                        "targetRef": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      }
                    ],
                    "height": 1.5,
                    "id": "example-value",
                    "name": "example-value",
                    "shapes": [
                      {
                        "collapsed": true,
                        "elementRef": "example-value",
                        "height": 1.5,
                        "id": "example-value",
                        "planningTableCollapsed": true,
                        "width": 1.5,
                        "x": 1.5,
                        "y": 1.5
                      }
                    ],
                    "width": 1.5
                  },
                  "fields": [
                    {
                      "description": "example-value",
                      "id": "example-value",
                      "label": "example-value",
                      "maximum": 1.5,
                      "minimum": 1.5,
                      "options": [
                        "example-value"
                      ],
                      "requiredAtStart": true,
                      "sensitive": true,
                      "type": "example-value"
                    }
                  ],
                  "format": "example-value",
                  "outcomes": [
                    "example-value"
                  ],
                  "policies": {
                    "allowReopen": true,
                    "classification": "example-value",
                    "completionMode": "example-value",
                    "retentionDays": 1
                  },
                  "purpose": "example-value",
                  "requirements": [
                    {
                      "appliesWhen": {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      },
                      "blocksCompletion": true,
                      "description": "example-value",
                      "due": {
                        "amount": 1,
                        "from": "example-value",
                        "unit": "example-value"
                      },
                      "enforcement": "example-value",
                      "fieldId": "example-value",
                      "id": "example-value",
                      "milestoneId": "example-value",
                      "name": "example-value",
                      "planItemId": "example-value",
                      "responsibleRole": "example-value",
                      "stageId": "example-value",
                      "type": "example-value",
                      "waivable": true,
                      "waiverRole": "example-value"
                    }
                  ],
                  "roles": [
                    {
                      "description": "example-value",
                      "id": "example-value",
                      "name": "example-value"
                    }
                  ],
                  "schemaVersion": 1,
                  "sentries": [
                    {
                      "id": "example-value",
                      "ifPart": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "name": "example-value",
                      "onParts": [
                        {
                          "exitCriterionRef": "example-value",
                          "id": "example-value",
                          "sourceRef": "example-value",
                          "sourceType": "example-value",
                          "standardEvent": "example-value"
                        }
                      ]
                    }
                  ],
                  "stages": [
                    {
                      "autoComplete": true,
                      "control": {
                        "manualActivation": {
                          "condition": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "sentryRef": "example-value"
                        },
                        "repetition": {
                          "condition": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "sentryRef": "example-value"
                        },
                        "required": {
                          "condition": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "sentryRef": "example-value"
                        }
                      },
                      "description": "example-value",
                      "entryCriteria": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "entrySentryRefs": [
                        "example-value"
                      ],
                      "exitCriteria": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "exitSentryRefs": [
                        "example-value"
                      ],
                      "id": "example-value",
                      "items": [
                        {
                          "authorizedRoles": [
                            "example-value"
                          ],
                          "blocking": true,
                          "caseTypeId": "example-value",
                          "caseTypeVersion": 1,
                          "children": [
                            {}
                          ],
                          "control": {
                            "manualActivation": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            },
                            "repetition": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            },
                            "required": {
                              "condition": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "sentryRef": "example-value"
                            }
                          },
                          "correlationField": "example-value",
                          "decision": {
                            "hitPolicy": "example-value",
                            "id": "example-value",
                            "inputs": [
                              {
                                "id": "example-value",
                                "label": "example-value"
                              }
                            ],
                            "name": "example-value",
                            "outputs": [
                              {
                                "id": "example-value",
                                "label": "example-value"
                              }
                            ],
                            "rules": [
                              {
                                "conditions": {},
                                "id": "example-value",
                                "outputs": {}
                              }
                            ]
                          },
                          "definitionRef": "example-value",
                          "description": "example-value",
                          "due": {
                            "amount": 1,
                            "from": "example-value",
                            "unit": "example-value"
                          },
                          "entryCriteria": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "entrySentryRefs": [
                            "example-value"
                          ],
                          "eventType": "example-value",
                          "exitCriteria": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "exitSentryRefs": [
                            "example-value"
                          ],
                          "externalImportType": "example-value",
                          "externalLocation": "example-value",
                          "externalNamespace": "example-value",
                          "externalPrefix": "example-value",
                          "externalRef": "example-value",
                          "id": "example-value",
                          "implementationType": "example-value",
                          "input": {},
                          "inputMappings": [
                            {
                              "id": "example-value",
                              "source": "example-value",
                              "target": "example-value",
                              "transformation": "example-value"
                            }
                          ],
                          "manualActivation": true,
                          "name": "example-value",
                          "outputMappings": [
                            {
                              "id": "example-value",
                              "source": "example-value",
                              "target": "example-value",
                              "transformation": "example-value"
                            }
                          ],
                          "planningTable": {
                            "applicabilityRules": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "authorizedRoles": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "itemRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "tables": [
                              {}
                            ]
                          },
                          "repeatable": true,
                          "required": true,
                          "roleId": "example-value",
                          "timeoutMinutes": 1,
                          "timerExpression": "example-value",
                          "timerStart": {
                            "exitCriterionRef": "example-value",
                            "id": "example-value",
                            "sourceRef": "example-value",
                            "sourceType": "example-value",
                            "standardEvent": "example-value"
                          },
                          "type": "example-value",
                          "workflowId": "example-value",
                          "workflowVersion": 1
                        }
                      ],
                      "manualActivation": true,
                      "name": "example-value",
                      "parentId": "example-value",
                      "planningTable": {
                        "applicabilityRules": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "authorizedRoles": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "itemRefs": [
                          "example-value"
                        ],
                        "name": "example-value",
                        "tables": [
                          {}
                        ]
                      },
                      "repeatable": true,
                      "required": true
                    }
                  ]
                },
                "description": "example-value",
                "displayName": "example-value",
                "slug": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/case-types"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/case-types"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Create case types. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/case-types/import/cmmn": {
      "post": {
        "description": "### Purpose\nCmmn case types. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiCaseTypesImportCmmn",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "description": "example-value",
                    "displayName": "Example DisplayName",
                    "slug": "example-resource"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {}
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "description": {
                    "description": "The description associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "displayName": {
                    "description": "The display name associated with this resource or operation.",
                    "example": "Example DisplayName",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "slug": {
                    "description": "The slug associated with this resource or operation.",
                    "example": "example-resource",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "caseType": {
                          "createdAt": "2026-08-28T00:00:00Z",
                          "createdBy": "example-value",
                          "definition": "example-value",
                          "description": "example-value",
                          "displayName": "example-value",
                          "id": "example-value",
                          "organizationId": "example-value",
                          "publishedVersion": 1,
                          "slug": "example-value",
                          "status": "example-value",
                          "updatedAt": "2026-08-28T00:00:00Z"
                        },
                        "report": {
                          "exactRoundTrip": true,
                          "imported": [
                            "example-value"
                          ],
                          "schemaValid": true,
                          "semanticSha256": "example-value",
                          "sourcePreserved": true,
                          "sourceSha256": "example-value",
                          "standard": "example-value",
                          "validation": {
                            "diagnostics": [
                              {
                                "code": "example-value",
                                "column": 1,
                                "line": 1,
                                "message": "example-value",
                                "path": "example-value"
                              }
                            ],
                            "namespace": "example-value",
                            "schemaValid": true,
                            "standard": "example-value",
                            "status": "example-value",
                            "version": "example-value"
                          },
                          "version": "example-value",
                          "warnings": [
                            "example-value"
                          ]
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "caseType": {
                          "$ref": "#/components/schemas/DatabaseCaseTypeRecordResponse",
                          "description": "The case type associated with this resource or operation.",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "report": {
                          "$ref": "#/components/schemas/CaseworkCMMNReportResponse",
                          "description": "The report associated with this resource or operation.",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "caseType",
                        "report"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Cmmn case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:87",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "case_type.cmmn_imported"
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "description": "example-value",
                "displayName": "Example DisplayName",
                "slug": "example-resource"
              },
              "method": "POST",
              "path": "/api/case-types/import/cmmn"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "description": "example-value",
                "displayName": "Example DisplayName",
                "slug": "example-resource"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/case-types/import/cmmn"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/case-types/import/cmmn"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Cmmn case types. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/case-types/import/cmmn/preview": {
      "post": {
        "description": "### Purpose\nPreview case types. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiCaseTypesImportCmmnPreview",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "definition": {
                          "artifacts": [
                            {
                              "direction": "example-value",
                              "id": "example-value",
                              "sourceRef": "example-value",
                              "targetRef": "example-value",
                              "text": "example-value",
                              "textFormat": "example-value",
                              "type": "example-value"
                            }
                          ],
                          "caseFile": [
                            {
                              "definitionRef": "example-value",
                              "definitionType": "example-value",
                              "id": "example-value",
                              "multiplicity": "example-value",
                              "name": "example-value",
                              "parentId": "example-value",
                              "properties": [
                                {
                                  "id": "example-value",
                                  "name": "example-value",
                                  "type": "example-value"
                                }
                              ],
                              "sourceRef": "example-value",
                              "structureRef": "example-value",
                              "targetRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "diagram": {
                            "edges": [
                              {
                                "elementRef": "example-value",
                                "id": "example-value",
                                "sourceRef": "example-value",
                                "standardEventVisible": true,
                                "targetRef": "example-value",
                                "waypoints": [
                                  {
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              }
                            ],
                            "height": 1.5,
                            "id": "example-value",
                            "name": "example-value",
                            "shapes": [
                              {
                                "collapsed": true,
                                "elementRef": "example-value",
                                "height": 1.5,
                                "id": "example-value",
                                "planningTableCollapsed": true,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              }
                            ],
                            "width": 1.5
                          },
                          "fields": [
                            {
                              "description": "example-value",
                              "id": "example-value",
                              "label": "example-value",
                              "maximum": 1.5,
                              "minimum": 1.5,
                              "options": [
                                "example-value"
                              ],
                              "requiredAtStart": true,
                              "sensitive": true,
                              "type": "example-value"
                            }
                          ],
                          "format": "example-value",
                          "outcomes": [
                            "example-value"
                          ],
                          "policies": {
                            "allowReopen": true,
                            "classification": "example-value",
                            "completionMode": "example-value",
                            "retentionDays": 1
                          },
                          "purpose": "example-value",
                          "requirements": [
                            {
                              "appliesWhen": {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              },
                              "blocksCompletion": true,
                              "description": "example-value",
                              "due": {
                                "amount": 1,
                                "from": "example-value",
                                "unit": "example-value"
                              },
                              "enforcement": "example-value",
                              "fieldId": "example-value",
                              "id": "example-value",
                              "milestoneId": "example-value",
                              "name": "example-value",
                              "planItemId": "example-value",
                              "responsibleRole": "example-value",
                              "stageId": "example-value",
                              "type": "example-value",
                              "waivable": true,
                              "waiverRole": "example-value"
                            }
                          ],
                          "roles": [
                            {
                              "description": "example-value",
                              "id": "example-value",
                              "name": "example-value"
                            }
                          ],
                          "schemaVersion": 1,
                          "sentries": [
                            {
                              "id": "example-value",
                              "ifPart": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "name": "example-value",
                              "onParts": [
                                {
                                  "exitCriterionRef": "example-value",
                                  "id": "example-value",
                                  "sourceRef": "example-value",
                                  "sourceType": "example-value",
                                  "standardEvent": "example-value"
                                }
                              ]
                            }
                          ],
                          "stages": [
                            {
                              "autoComplete": true,
                              "control": {
                                "manualActivation": {
                                  "condition": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "sentryRef": "example-value"
                                },
                                "repetition": {
                                  "condition": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "sentryRef": "example-value"
                                },
                                "required": {
                                  "condition": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "sentryRef": "example-value"
                                }
                              },
                              "description": "example-value",
                              "entryCriteria": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "entrySentryRefs": [
                                "example-value"
                              ],
                              "exitCriteria": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "exitSentryRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "items": [
                                {
                                  "authorizedRoles": [
                                    "example-value"
                                  ],
                                  "blocking": true,
                                  "caseTypeId": "example-value",
                                  "caseTypeVersion": 1,
                                  "children": [
                                    {}
                                  ],
                                  "control": {
                                    "manualActivation": {
                                      "condition": [
                                        {
                                          "expressionLanguage": "example-value",
                                          "operator": "example-value",
                                          "source": "example-value",
                                          "value": "example-value"
                                        }
                                      ],
                                      "sentryRef": "example-value"
                                    },
                                    "repetition": {
                                      "condition": [
                                        {
                                          "expressionLanguage": "example-value",
                                          "operator": "example-value",
                                          "source": "example-value",
                                          "value": "example-value"
                                        }
                                      ],
                                      "sentryRef": "example-value"
                                    },
                                    "required": {
                                      "condition": [
                                        {
                                          "expressionLanguage": "example-value",
                                          "operator": "example-value",
                                          "source": "example-value",
                                          "value": "example-value"
                                        }
                                      ],
                                      "sentryRef": "example-value"
                                    }
                                  },
                                  "correlationField": "example-value",
                                  "decision": {
                                    "hitPolicy": "example-value",
                                    "id": "example-value",
                                    "inputs": [
                                      {
                                        "id": "example-value",
                                        "label": "example-value"
                                      }
                                    ],
                                    "name": "example-value",
                                    "outputs": [
                                      {
                                        "id": "example-value",
                                        "label": "example-value"
                                      }
                                    ],
                                    "rules": [
                                      {
                                        "conditions": {},
                                        "id": "example-value",
                                        "outputs": {}
                                      }
                                    ]
                                  },
                                  "definitionRef": "example-value",
                                  "description": "example-value",
                                  "due": {
                                    "amount": 1,
                                    "from": "example-value",
                                    "unit": "example-value"
                                  },
                                  "entryCriteria": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "entrySentryRefs": [
                                    "example-value"
                                  ],
                                  "eventType": "example-value",
                                  "exitCriteria": [
                                    {
                                      "expressionLanguage": "example-value",
                                      "operator": "example-value",
                                      "source": "example-value",
                                      "value": "example-value"
                                    }
                                  ],
                                  "exitSentryRefs": [
                                    "example-value"
                                  ],
                                  "externalImportType": "example-value",
                                  "externalLocation": "example-value",
                                  "externalNamespace": "example-value",
                                  "externalPrefix": "example-value",
                                  "externalRef": "example-value",
                                  "id": "example-value",
                                  "implementationType": "example-value",
                                  "input": {},
                                  "inputMappings": [
                                    {
                                      "id": "example-value",
                                      "source": "example-value",
                                      "target": "example-value",
                                      "transformation": "example-value"
                                    }
                                  ],
                                  "manualActivation": true,
                                  "name": "example-value",
                                  "outputMappings": [
                                    {
                                      "id": "example-value",
                                      "source": "example-value",
                                      "target": "example-value",
                                      "transformation": "example-value"
                                    }
                                  ],
                                  "planningTable": {
                                    "applicabilityRules": [
                                      {
                                        "expressionLanguage": "example-value",
                                        "operator": "example-value",
                                        "source": "example-value",
                                        "value": "example-value"
                                      }
                                    ],
                                    "authorizedRoles": [
                                      "example-value"
                                    ],
                                    "id": "example-value",
                                    "itemRefs": [
                                      "example-value"
                                    ],
                                    "name": "example-value",
                                    "tables": [
                                      {}
                                    ]
                                  },
                                  "repeatable": true,
                                  "required": true,
                                  "roleId": "example-value",
                                  "timeoutMinutes": 1,
                                  "timerExpression": "example-value",
                                  "timerStart": {
                                    "exitCriterionRef": "example-value",
                                    "id": "example-value",
                                    "sourceRef": "example-value",
                                    "sourceType": "example-value",
                                    "standardEvent": "example-value"
                                  },
                                  "type": "example-value",
                                  "workflowId": "example-value",
                                  "workflowVersion": 1
                                }
                              ],
                              "manualActivation": true,
                              "name": "example-value",
                              "parentId": "example-value",
                              "planningTable": {
                                "applicabilityRules": [
                                  {
                                    "expressionLanguage": "example-value",
                                    "operator": "example-value",
                                    "source": "example-value",
                                    "value": "example-value"
                                  }
                                ],
                                "authorizedRoles": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "itemRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "tables": [
                                  {}
                                ]
                              },
                              "repeatable": true,
                              "required": true
                            }
                          ]
                        },
                        "report": {
                          "exactRoundTrip": true,
                          "imported": [
                            "example-value"
                          ],
                          "schemaValid": true,
                          "semanticSha256": "example-value",
                          "sourcePreserved": true,
                          "sourceSha256": "example-value",
                          "standard": "example-value",
                          "validation": {
                            "diagnostics": [
                              {
                                "code": "example-value",
                                "column": 1,
                                "line": 1,
                                "message": "example-value",
                                "path": "example-value"
                              }
                            ],
                            "namespace": "example-value",
                            "schemaValid": true,
                            "standard": "example-value",
                            "status": "example-value",
                            "version": "example-value"
                          },
                          "version": "example-value",
                          "warnings": [
                            "example-value"
                          ]
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "definition": {
                          "$ref": "#/components/schemas/CaseworkDefinitionResponse",
                          "description": "The definition associated with this resource or operation.",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "report": {
                          "$ref": "#/components/schemas/CaseworkCMMNReportResponse",
                          "description": "The report associated with this resource or operation.",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "definition",
                        "report"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Preview case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:70",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/case-types/import/cmmn/preview"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/case-types/import/cmmn/preview"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/case-types/import/cmmn/preview"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Preview case types. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/case-types/{caseTypeId}": {
      "delete": {
        "description": "### Purpose\nDelete case types. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiCaseTypesCaseTypeId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:138",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "case_type.deleted"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete case types. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiCaseEvents",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "get": {
        "description": "### Purpose\nGet case types. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiCaseTypesCaseTypeId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:106",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get case types. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiCaseEvents",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "patch": {
        "description": "### Purpose\nUpdate case types. This applies only the supplied changes.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "patchapiCaseTypesCaseTypeId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "description": "Handles a fictitious customer complaint from intake to closure.",
                    "displayName": "Customer complaint",
                    "status": "published"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {}
                }
              },
              "schema": {
                "additionalProperties": false,
                "description": "A partial update. Supply at least one documented property; omitted properties remain unchanged.",
                "minProperties": 1,
                "properties": {
                  "description": {
                    "description": "Case-type purpose and scope shown to users.",
                    "example": "Handles a fictitious customer complaint from intake to closure.",
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "An empty string clears the description; null is not a documented value.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable while the case type exists.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  },
                  "displayName": {
                    "description": "Human-readable case-type name shown to users.",
                    "example": "Customer complaint",
                    "minLength": 1,
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "An empty or whitespace-only value is ignored; omit the field to retain the current name.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable while the case type exists.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  },
                  "status": {
                    "description": "Requested case-type lifecycle state.",
                    "enum": [
                      "draft",
                      "published",
                      "retired"
                    ],
                    "example": "published",
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "Omit the field to retain the current state; empty and null values are ignored and should not be sent.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "State-dependent; use only a lifecycle transition permitted by the current case type.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:119",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "case_type.updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "description": "Handles a fictitious customer complaint from intake to closure.",
                "displayName": "Customer complaint",
                "status": "published"
              },
              "method": "PATCH",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "description": "Handles a fictitious customer complaint from intake to closure.",
                "displayName": "Customer complaint",
                "status": "published"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PATCH",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PATCH",
              "path": "/api/case-types/example-caseTypeId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Update case types. This applies only the supplied changes.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "postapiCaseEvents",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/case-types/{caseTypeId}/draft": {
      "put": {
        "description": "### Purpose\nDraft case types. This replaces or sets the selected state using the full supplied value.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "putapiCaseTypesCaseTypeIdDraft",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "artifacts": [
                      {
                        "direction": "example-value",
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "targetRef": "example-value",
                        "text": "example-value",
                        "textFormat": "example-value",
                        "type": "example-value"
                      }
                    ],
                    "caseFile": [
                      {
                        "definitionRef": "example-value",
                        "definitionType": "example-value",
                        "id": "example-value",
                        "multiplicity": "example-value",
                        "name": "example-value",
                        "parentId": "example-value",
                        "properties": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "sourceRef": "example-value",
                        "structureRef": "example-value",
                        "targetRefs": [
                          "example-value"
                        ]
                      }
                    ],
                    "diagram": {
                      "edges": [
                        {
                          "elementRef": "example-value",
                          "id": "example-value",
                          "sourceRef": "example-value",
                          "standardEventVisible": true,
                          "targetRef": "example-value",
                          "waypoints": [
                            {
                              "x": 1.5,
                              "y": 1.5
                            }
                          ]
                        }
                      ],
                      "height": 1.5,
                      "id": "example-value",
                      "name": "example-value",
                      "shapes": [
                        {
                          "collapsed": true,
                          "elementRef": "example-value",
                          "height": 1.5,
                          "id": "example-value",
                          "planningTableCollapsed": true,
                          "width": 1.5,
                          "x": 1.5,
                          "y": 1.5
                        }
                      ],
                      "width": 1.5
                    },
                    "fields": [
                      {
                        "description": "example-value",
                        "id": "example-value",
                        "label": "example-value",
                        "maximum": 1.5,
                        "minimum": 1.5,
                        "options": [
                          "example-value"
                        ],
                        "requiredAtStart": true,
                        "sensitive": true,
                        "type": "example-value"
                      }
                    ],
                    "format": "example-value",
                    "outcomes": [
                      "example-value"
                    ],
                    "policies": {
                      "allowReopen": true,
                      "classification": "example-value",
                      "completionMode": "example-value",
                      "retentionDays": 1
                    },
                    "purpose": "example-value",
                    "requirements": [
                      {
                        "appliesWhen": {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        },
                        "blocksCompletion": true,
                        "description": "example-value",
                        "due": {
                          "amount": 1,
                          "from": "example-value",
                          "unit": "example-value"
                        },
                        "enforcement": "example-value",
                        "fieldId": "example-value",
                        "id": "example-value",
                        "milestoneId": "example-value",
                        "name": "example-value",
                        "planItemId": "example-value",
                        "responsibleRole": "example-value",
                        "stageId": "example-value",
                        "type": "example-value",
                        "waivable": true,
                        "waiverRole": "example-value"
                      }
                    ],
                    "roles": [
                      {
                        "description": "example-value",
                        "id": "example-value",
                        "name": "example-value"
                      }
                    ],
                    "schemaVersion": 1,
                    "sentries": [
                      {
                        "id": "example-value",
                        "ifPart": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "onParts": [
                          {
                            "exitCriterionRef": "example-value",
                            "id": "example-value",
                            "sourceRef": "example-value",
                            "sourceType": "example-value",
                            "standardEvent": "example-value"
                          }
                        ]
                      }
                    ],
                    "stages": [
                      {
                        "autoComplete": true,
                        "control": {
                          "manualActivation": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          },
                          "repetition": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          },
                          "required": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          }
                        },
                        "description": "example-value",
                        "entryCriteria": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "entrySentryRefs": [
                          "example-value"
                        ],
                        "exitCriteria": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "exitSentryRefs": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "items": [
                          {
                            "authorizedRoles": [
                              "example-value"
                            ],
                            "blocking": true,
                            "caseTypeId": "example-value",
                            "caseTypeVersion": 1,
                            "children": [
                              {}
                            ],
                            "control": {
                              "manualActivation": {
                                "condition": [
                                  {
                                    "expressionLanguage": "example-value",
                                    "operator": "example-value",
                                    "source": "example-value",
                                    "value": "example-value"
                                  }
                                ],
                                "sentryRef": "example-value"
                              },
                              "repetition": {
                                "condition": [
                                  {
                                    "expressionLanguage": "example-value",
                                    "operator": "example-value",
                                    "source": "example-value",
                                    "value": "example-value"
                                  }
                                ],
                                "sentryRef": "example-value"
                              },
                              "required": {
                                "condition": [
                                  {
                                    "expressionLanguage": "example-value",
                                    "operator": "example-value",
                                    "source": "example-value",
                                    "value": "example-value"
                                  }
                                ],
                                "sentryRef": "example-value"
                              }
                            },
                            "correlationField": "example-value",
                            "decision": {
                              "hitPolicy": "example-value",
                              "id": "example-value",
                              "inputs": [
                                {
                                  "id": "example-value",
                                  "label": "example-value"
                                }
                              ],
                              "name": "example-value",
                              "outputs": [
                                {
                                  "id": "example-value",
                                  "label": "example-value"
                                }
                              ],
                              "rules": [
                                {
                                  "conditions": {},
                                  "id": "example-value",
                                  "outputs": {}
                                }
                              ]
                            },
                            "definitionRef": "example-value",
                            "description": "example-value",
                            "due": {
                              "amount": 1,
                              "from": "example-value",
                              "unit": "example-value"
                            },
                            "entryCriteria": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "entrySentryRefs": [
                              "example-value"
                            ],
                            "eventType": "example-value",
                            "exitCriteria": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "exitSentryRefs": [
                              "example-value"
                            ],
                            "externalImportType": "example-value",
                            "externalLocation": "example-value",
                            "externalNamespace": "example-value",
                            "externalPrefix": "example-value",
                            "externalRef": "example-value",
                            "id": "example-value",
                            "implementationType": "example-value",
                            "input": {},
                            "inputMappings": [
                              {
                                "id": "example-value",
                                "source": "example-value",
                                "target": "example-value",
                                "transformation": "example-value"
                              }
                            ],
                            "manualActivation": true,
                            "name": "example-value",
                            "outputMappings": [
                              {
                                "id": "example-value",
                                "source": "example-value",
                                "target": "example-value",
                                "transformation": "example-value"
                              }
                            ],
                            "planningTable": {
                              "applicabilityRules": [
                                {
                                  "expressionLanguage": "example-value",
                                  "operator": "example-value",
                                  "source": "example-value",
                                  "value": "example-value"
                                }
                              ],
                              "authorizedRoles": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "itemRefs": [
                                "example-value"
                              ],
                              "name": "example-value",
                              "tables": [
                                {}
                              ]
                            },
                            "repeatable": true,
                            "required": true,
                            "roleId": "example-value",
                            "timeoutMinutes": 1,
                            "timerExpression": "example-value",
                            "timerStart": {
                              "exitCriterionRef": "example-value",
                              "id": "example-value",
                              "sourceRef": "example-value",
                              "sourceType": "example-value",
                              "standardEvent": "example-value"
                            },
                            "type": "example-value",
                            "workflowId": "example-value",
                            "workflowVersion": 1
                          }
                        ],
                        "manualActivation": true,
                        "name": "example-value",
                        "parentId": "example-value",
                        "planningTable": {
                          "applicabilityRules": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "authorizedRoles": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "itemRefs": [
                            "example-value"
                          ],
                          "name": "example-value",
                          "tables": [
                            {}
                          ]
                        },
                        "repeatable": true,
                        "required": true
                      }
                    ]
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "fields": [
                      {
                        "id": "example-value",
                        "label": "example-value",
                        "type": "example-value"
                      }
                    ],
                    "format": "example-value",
                    "outcomes": [
                      "example-value"
                    ],
                    "policies": {
                      "allowReopen": true,
                      "completionMode": "example-value"
                    },
                    "purpose": "example-value",
                    "requirements": [
                      {
                        "blocksCompletion": true,
                        "enforcement": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "type": "example-value",
                        "waivable": true
                      }
                    ],
                    "roles": [
                      {
                        "id": "example-value",
                        "name": "example-value"
                      }
                    ],
                    "schemaVersion": 1,
                    "stages": [
                      {
                        "id": "example-value",
                        "items": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "required": true,
                            "type": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "required": true
                      }
                    ]
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/CaseworkDefinitionRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Draft case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:152",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "case_type.draft_saved"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "artifacts": [
                  {
                    "direction": "example-value",
                    "id": "example-value",
                    "sourceRef": "example-value",
                    "targetRef": "example-value",
                    "text": "example-value",
                    "textFormat": "example-value",
                    "type": "example-value"
                  }
                ],
                "caseFile": [
                  {
                    "definitionRef": "example-value",
                    "definitionType": "example-value",
                    "id": "example-value",
                    "multiplicity": "example-value",
                    "name": "example-value",
                    "parentId": "example-value",
                    "properties": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "type": "example-value"
                      }
                    ],
                    "sourceRef": "example-value",
                    "structureRef": "example-value",
                    "targetRefs": [
                      "example-value"
                    ]
                  }
                ],
                "diagram": {
                  "edges": [
                    {
                      "elementRef": "example-value",
                      "id": "example-value",
                      "sourceRef": "example-value",
                      "standardEventVisible": true,
                      "targetRef": "example-value",
                      "waypoints": [
                        {
                          "x": 1.5,
                          "y": 1.5
                        }
                      ]
                    }
                  ],
                  "height": 1.5,
                  "id": "example-value",
                  "name": "example-value",
                  "shapes": [
                    {
                      "collapsed": true,
                      "elementRef": "example-value",
                      "height": 1.5,
                      "id": "example-value",
                      "planningTableCollapsed": true,
                      "width": 1.5,
                      "x": 1.5,
                      "y": 1.5
                    }
                  ],
                  "width": 1.5
                },
                "fields": [
                  {
                    "description": "example-value",
                    "id": "example-value",
                    "label": "example-value",
                    "maximum": 1.5,
                    "minimum": 1.5,
                    "options": [
                      "example-value"
                    ],
                    "requiredAtStart": true,
                    "sensitive": true,
                    "type": "example-value"
                  }
                ],
                "format": "example-value",
                "outcomes": [
                  "example-value"
                ],
                "policies": {
                  "allowReopen": true,
                  "classification": "example-value",
                  "completionMode": "example-value",
                  "retentionDays": 1
                },
                "purpose": "example-value",
                "requirements": [
                  {
                    "appliesWhen": {
                      "expressionLanguage": "example-value",
                      "operator": "example-value",
                      "source": "example-value",
                      "value": "example-value"
                    },
                    "blocksCompletion": true,
                    "description": "example-value",
                    "due": {
                      "amount": 1,
                      "from": "example-value",
                      "unit": "example-value"
                    },
                    "enforcement": "example-value",
                    "fieldId": "example-value",
                    "id": "example-value",
                    "milestoneId": "example-value",
                    "name": "example-value",
                    "planItemId": "example-value",
                    "responsibleRole": "example-value",
                    "stageId": "example-value",
                    "type": "example-value",
                    "waivable": true,
                    "waiverRole": "example-value"
                  }
                ],
                "roles": [
                  {
                    "description": "example-value",
                    "id": "example-value",
                    "name": "example-value"
                  }
                ],
                "schemaVersion": 1,
                "sentries": [
                  {
                    "id": "example-value",
                    "ifPart": [
                      {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      }
                    ],
                    "name": "example-value",
                    "onParts": [
                      {
                        "exitCriterionRef": "example-value",
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "sourceType": "example-value",
                        "standardEvent": "example-value"
                      }
                    ]
                  }
                ],
                "stages": [
                  {
                    "autoComplete": true,
                    "control": {
                      "manualActivation": {
                        "condition": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "sentryRef": "example-value"
                      },
                      "repetition": {
                        "condition": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "sentryRef": "example-value"
                      },
                      "required": {
                        "condition": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "sentryRef": "example-value"
                      }
                    },
                    "description": "example-value",
                    "entryCriteria": [
                      {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      }
                    ],
                    "entrySentryRefs": [
                      "example-value"
                    ],
                    "exitCriteria": [
                      {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      }
                    ],
                    "exitSentryRefs": [
                      "example-value"
                    ],
                    "id": "example-value",
                    "items": [
                      {
                        "authorizedRoles": [
                          "example-value"
                        ],
                        "blocking": true,
                        "caseTypeId": "example-value",
                        "caseTypeVersion": 1,
                        "children": [
                          {}
                        ],
                        "control": {
                          "manualActivation": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          },
                          "repetition": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          },
                          "required": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          }
                        },
                        "correlationField": "example-value",
                        "decision": {
                          "hitPolicy": "example-value",
                          "id": "example-value",
                          "inputs": [
                            {
                              "id": "example-value",
                              "label": "example-value"
                            }
                          ],
                          "name": "example-value",
                          "outputs": [
                            {
                              "id": "example-value",
                              "label": "example-value"
                            }
                          ],
                          "rules": [
                            {
                              "conditions": {},
                              "id": "example-value",
                              "outputs": {}
                            }
                          ]
                        },
                        "definitionRef": "example-value",
                        "description": "example-value",
                        "due": {
                          "amount": 1,
                          "from": "example-value",
                          "unit": "example-value"
                        },
                        "entryCriteria": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "entrySentryRefs": [
                          "example-value"
                        ],
                        "eventType": "example-value",
                        "exitCriteria": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "exitSentryRefs": [
                          "example-value"
                        ],
                        "externalImportType": "example-value",
                        "externalLocation": "example-value",
                        "externalNamespace": "example-value",
                        "externalPrefix": "example-value",
                        "externalRef": "example-value",
                        "id": "example-value",
                        "implementationType": "example-value",
                        "input": {},
                        "inputMappings": [
                          {
                            "id": "example-value",
                            "source": "example-value",
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "manualActivation": true,
                        "name": "example-value",
                        "outputMappings": [
                          {
                            "id": "example-value",
                            "source": "example-value",
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "planningTable": {
                          "applicabilityRules": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "authorizedRoles": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "itemRefs": [
                            "example-value"
                          ],
                          "name": "example-value",
                          "tables": [
                            {}
                          ]
                        },
                        "repeatable": true,
                        "required": true,
                        "roleId": "example-value",
                        "timeoutMinutes": 1,
                        "timerExpression": "example-value",
                        "timerStart": {
                          "exitCriterionRef": "example-value",
                          "id": "example-value",
                          "sourceRef": "example-value",
                          "sourceType": "example-value",
                          "standardEvent": "example-value"
                        },
                        "type": "example-value",
                        "workflowId": "example-value",
                        "workflowVersion": 1
                      }
                    ],
                    "manualActivation": true,
                    "name": "example-value",
                    "parentId": "example-value",
                    "planningTable": {
                      "applicabilityRules": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "authorizedRoles": [
                        "example-value"
                      ],
                      "id": "example-value",
                      "itemRefs": [
                        "example-value"
                      ],
                      "name": "example-value",
                      "tables": [
                        {}
                      ]
                    },
                    "repeatable": true,
                    "required": true
                  }
                ]
              },
              "method": "PUT",
              "path": "/api/case-types/example-caseTypeId/draft"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "artifacts": [
                  {
                    "direction": "example-value",
                    "id": "example-value",
                    "sourceRef": "example-value",
                    "targetRef": "example-value",
                    "text": "example-value",
                    "textFormat": "example-value",
                    "type": "example-value"
                  }
                ],
                "caseFile": [
                  {
                    "definitionRef": "example-value",
                    "definitionType": "example-value",
                    "id": "example-value",
                    "multiplicity": "example-value",
                    "name": "example-value",
                    "parentId": "example-value",
                    "properties": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "type": "example-value"
                      }
                    ],
                    "sourceRef": "example-value",
                    "structureRef": "example-value",
                    "targetRefs": [
                      "example-value"
                    ]
                  }
                ],
                "diagram": {
                  "edges": [
                    {
                      "elementRef": "example-value",
                      "id": "example-value",
                      "sourceRef": "example-value",
                      "standardEventVisible": true,
                      "targetRef": "example-value",
                      "waypoints": [
                        {
                          "x": 1.5,
                          "y": 1.5
                        }
                      ]
                    }
                  ],
                  "height": 1.5,
                  "id": "example-value",
                  "name": "example-value",
                  "shapes": [
                    {
                      "collapsed": true,
                      "elementRef": "example-value",
                      "height": 1.5,
                      "id": "example-value",
                      "planningTableCollapsed": true,
                      "width": 1.5,
                      "x": 1.5,
                      "y": 1.5
                    }
                  ],
                  "width": 1.5
                },
                "fields": [
                  {
                    "description": "example-value",
                    "id": "example-value",
                    "label": "example-value",
                    "maximum": 1.5,
                    "minimum": 1.5,
                    "options": [
                      "example-value"
                    ],
                    "requiredAtStart": true,
                    "sensitive": true,
                    "type": "example-value"
                  }
                ],
                "format": "example-value",
                "outcomes": [
                  "example-value"
                ],
                "policies": {
                  "allowReopen": true,
                  "classification": "example-value",
                  "completionMode": "example-value",
                  "retentionDays": 1
                },
                "purpose": "example-value",
                "requirements": [
                  {
                    "appliesWhen": {
                      "expressionLanguage": "example-value",
                      "operator": "example-value",
                      "source": "example-value",
                      "value": "example-value"
                    },
                    "blocksCompletion": true,
                    "description": "example-value",
                    "due": {
                      "amount": 1,
                      "from": "example-value",
                      "unit": "example-value"
                    },
                    "enforcement": "example-value",
                    "fieldId": "example-value",
                    "id": "example-value",
                    "milestoneId": "example-value",
                    "name": "example-value",
                    "planItemId": "example-value",
                    "responsibleRole": "example-value",
                    "stageId": "example-value",
                    "type": "example-value",
                    "waivable": true,
                    "waiverRole": "example-value"
                  }
                ],
                "roles": [
                  {
                    "description": "example-value",
                    "id": "example-value",
                    "name": "example-value"
                  }
                ],
                "schemaVersion": 1,
                "sentries": [
                  {
                    "id": "example-value",
                    "ifPart": [
                      {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      }
                    ],
                    "name": "example-value",
                    "onParts": [
                      {
                        "exitCriterionRef": "example-value",
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "sourceType": "example-value",
                        "standardEvent": "example-value"
                      }
                    ]
                  }
                ],
                "stages": [
                  {
                    "autoComplete": true,
                    "control": {
                      "manualActivation": {
                        "condition": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "sentryRef": "example-value"
                      },
                      "repetition": {
                        "condition": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "sentryRef": "example-value"
                      },
                      "required": {
                        "condition": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "sentryRef": "example-value"
                      }
                    },
                    "description": "example-value",
                    "entryCriteria": [
                      {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      }
                    ],
                    "entrySentryRefs": [
                      "example-value"
                    ],
                    "exitCriteria": [
                      {
                        "expressionLanguage": "example-value",
                        "operator": "example-value",
                        "source": "example-value",
                        "value": "example-value"
                      }
                    ],
                    "exitSentryRefs": [
                      "example-value"
                    ],
                    "id": "example-value",
                    "items": [
                      {
                        "authorizedRoles": [
                          "example-value"
                        ],
                        "blocking": true,
                        "caseTypeId": "example-value",
                        "caseTypeVersion": 1,
                        "children": [
                          {}
                        ],
                        "control": {
                          "manualActivation": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          },
                          "repetition": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          },
                          "required": {
                            "condition": [
                              {
                                "expressionLanguage": "example-value",
                                "operator": "example-value",
                                "source": "example-value",
                                "value": "example-value"
                              }
                            ],
                            "sentryRef": "example-value"
                          }
                        },
                        "correlationField": "example-value",
                        "decision": {
                          "hitPolicy": "example-value",
                          "id": "example-value",
                          "inputs": [
                            {
                              "id": "example-value",
                              "label": "example-value"
                            }
                          ],
                          "name": "example-value",
                          "outputs": [
                            {
                              "id": "example-value",
                              "label": "example-value"
                            }
                          ],
                          "rules": [
                            {
                              "conditions": {},
                              "id": "example-value",
                              "outputs": {}
                            }
                          ]
                        },
                        "definitionRef": "example-value",
                        "description": "example-value",
                        "due": {
                          "amount": 1,
                          "from": "example-value",
                          "unit": "example-value"
                        },
                        "entryCriteria": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "entrySentryRefs": [
                          "example-value"
                        ],
                        "eventType": "example-value",
                        "exitCriteria": [
                          {
                            "expressionLanguage": "example-value",
                            "operator": "example-value",
                            "source": "example-value",
                            "value": "example-value"
                          }
                        ],
                        "exitSentryRefs": [
                          "example-value"
                        ],
                        "externalImportType": "example-value",
                        "externalLocation": "example-value",
                        "externalNamespace": "example-value",
                        "externalPrefix": "example-value",
                        "externalRef": "example-value",
                        "id": "example-value",
                        "implementationType": "example-value",
                        "input": {},
                        "inputMappings": [
                          {
                            "id": "example-value",
                            "source": "example-value",
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "manualActivation": true,
                        "name": "example-value",
                        "outputMappings": [
                          {
                            "id": "example-value",
                            "source": "example-value",
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "planningTable": {
                          "applicabilityRules": [
                            {
                              "expressionLanguage": "example-value",
                              "operator": "example-value",
                              "source": "example-value",
                              "value": "example-value"
                            }
                          ],
                          "authorizedRoles": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "itemRefs": [
                            "example-value"
                          ],
                          "name": "example-value",
                          "tables": [
                            {}
                          ]
                        },
                        "repeatable": true,
                        "required": true,
                        "roleId": "example-value",
                        "timeoutMinutes": 1,
                        "timerExpression": "example-value",
                        "timerStart": {
                          "exitCriterionRef": "example-value",
                          "id": "example-value",
                          "sourceRef": "example-value",
                          "sourceType": "example-value",
                          "standardEvent": "example-value"
                        },
                        "type": "example-value",
                        "workflowId": "example-value",
                        "workflowVersion": 1
                      }
                    ],
                    "manualActivation": true,
                    "name": "example-value",
                    "parentId": "example-value",
                    "planningTable": {
                      "applicabilityRules": [
                        {
                          "expressionLanguage": "example-value",
                          "operator": "example-value",
                          "source": "example-value",
                          "value": "example-value"
                        }
                      ],
                      "authorizedRoles": [
                        "example-value"
                      ],
                      "id": "example-value",
                      "itemRefs": [
                        "example-value"
                      ],
                      "name": "example-value",
                      "tables": [
                        {}
                      ]
                    },
                    "repeatable": true,
                    "required": true
                  }
                ]
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PUT",
              "path": "/api/case-types/example-caseTypeId/draft"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PUT",
              "path": "/api/case-types/example-caseTypeId/draft"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Draft case types. This replaces or sets the selected state using the full supplied value.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/case-types/{caseTypeId}/export/cmmn": {
      "get": {
        "description": "### Purpose\nGet case types export. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get case types export",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:211",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId/export/cmmn"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId/export/cmmn"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId/export/cmmn"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get case types export. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiCaseEvents",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/case-types/{caseTypeId}/publish": {
      "post": {
        "description": "### Purpose\nPublish case types. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiCaseTypesCaseTypeIdPublish",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Publish case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "publish",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:184",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "case_type.published"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/case-types/example-caseTypeId/publish"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/case-types/example-caseTypeId/publish"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/case-types/example-caseTypeId/publish"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Publish case types. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/case-types/{caseTypeId}/validate": {
      "post": {
        "description": "### Purpose\nValidate case types. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this before the related state-changing action to confirm that the proposed configuration or resource is usable.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiCaseTypesCaseTypeIdValidate",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Validation or connectivity check completed; the response explains the current result.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Validate case types",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:171",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/case-types/example-caseTypeId/validate"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/case-types/example-caseTypeId/validate"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/case-types/example-caseTypeId/validate"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Validate case types. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdVersions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this before the related state-changing action to confirm that the proposed configuration or resource is usable."
      }
    },
    "/api/case-types/{caseTypeId}/versions": {
      "get": {
        "description": "### Purpose\nGet case types versions. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiCaseTypesCaseTypeIdVersions",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The case type id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "caseTypeId",
            "required": true,
            "schema": {
              "description": "The case type id that identifies the resource selected by this operation.",
              "example": "example-casetypeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get case types versions",
        "tags": [
          "Cases and case types"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "cases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-casetypeid",
          "resourceType": "case_type",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "cases.go:198",
          "owner": "Cases and case types",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId/versions"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId/versions"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/case-types/example-caseTypeId/versions"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get case types versions. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiCaseTypesCaseTypeId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiCaseTypes",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiCaseTypesCaseTypeIdExportCmmn",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiCaseTypesCaseTypeId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiCaseEvents",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/chat": {
      "post": {
        "description": "### Purpose\nCreate chat. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiChat",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Ordinary JSON reply from an explicitly selected deployment",
                  "value": {
                    "deploymentId": "example-deployment-id",
                    "maxTokens": 128,
                    "messages": [
                      {
                        "content": "Reply with a short greeting.",
                        "role": "user"
                      }
                    ],
                    "stream": false,
                    "temperature": 0.2
                  }
                },
                "localStreaming": {
                  "summary": "Separate streaming request for a local llama.cpp deployment only",
                  "value": {
                    "deploymentId": "example-local-deployment-id",
                    "maxTokens": 128,
                    "messages": [
                      {
                        "content": "Reply with a short greeting.",
                        "role": "user"
                      }
                    ],
                    "stream": true
                  }
                },
                "smallestValid": {
                  "summary": "JSON reply using the first available tenant deployment",
                  "value": {
                    "messages": [
                      {
                        "content": "Reply with a short greeting.",
                        "role": "user"
                      }
                    ]
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "description": "Generate a chat reply. Select a tenant deployment with `deploymentId`, or the `model` alias. If both are omitted or empty, the first deployment returned for this tenant is used. `MODEL_REQUIRED` is returned when none exists. Omit `stream` or set it to false for an ordinary JSON response.",
                "properties": {
                  "deploymentId": {
                    "description": "Tenant deployment identifier. Takes precedence over model when nonempty; obtain an identifier from GET /api/models.",
                    "example": "example-deployment-id",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "An omitted or empty deploymentId uses model; when both are omitted or empty, the first tenant deployment is used. There is no fixed deployment default.",
                    "x-punaha-empty": "Omission or an empty string selects model, then the first tenant deployment. Null is not a documented input.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "maxTokens": {
                    "description": "Optional generation-token limit. Limits and defaults depend on the selected provider: local llama.cpp uses 512 for values below 1 and caps values above 8192; Anthropic uses at least 1024; other current adapters send a limit only when it is positive and otherwise leave the provider default in effect.",
                    "example": 128,
                    "format": "int64",
                    "type": "integer",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No universal token default. Local llama.cpp uses 512 for omitted or nonpositive values; Anthropic uses 1024; other adapters use their provider default.",
                    "x-punaha-empty": "Omission is decoded as zero. Zero or a negative value uses the provider-specific fallback; it does not request a zero-length reply. Null is not a documented input.",
                    "x-punaha-handling": "A generation setting; do not confuse this field with an authentication token.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "messages": {
                    "description": "The messages associated with this resource or operation.",
                    "example": [
                      "example-value"
                    ],
                    "items": {
                      "$ref": "#/components/schemas/ModelsMessageRequest"
                    },
                    "type": "array",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "model": {
                    "description": "Compatibility alias for a tenant deployment identifier, not a provider model name. Used only when deploymentId is omitted or empty.",
                    "example": "example-deployment-id",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "An omitted or empty deploymentId uses model; when both are omitted or empty, the first tenant deployment is used. There is no fixed deployment default.",
                    "x-punaha-empty": "Omission or an empty string uses the first tenant deployment when deploymentId is also omitted or empty. Null is not a documented input.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "stream": {
                    "default": false,
                    "description": "When true, request Server-Sent Events from a local llama.cpp deployment. External providers reject streaming with CHAT_STREAMING_UNSUPPORTED before any event is sent.",
                    "example": false,
                    "type": "boolean",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "Defaults to false when omitted.",
                    "x-punaha-empty": "Omission and false select the ordinary JSON response. Null is not a documented input.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "temperature": {
                    "anyOf": [
                      {
                        "format": "double",
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Optional sampling temperature passed to the selected provider. An explicit zero is preserved; provider-specific limits and defaults apply.",
                    "example": 0.2,
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No universal temperature default; the selected runtime or provider supplies its default when omitted or null.",
                    "x-punaha-empty": "Omission or null leaves the temperature unspecified. Zero is an explicit value, not omission.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-nullable": true,
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "messages"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "description": "When stream is omitted or false, the completed ChatResult is wrapped in the ordinary data envelope. Optional usage, performance and raw values depend on the selected provider.",
                "examples": {
                  "success": {
                    "summary": "Completed ordinary JSON reply",
                    "value": {
                      "data": {
                        "message": {
                          "content": "Hello.",
                          "role": "assistant"
                        },
                        "model": "example-model",
                        "usage": {
                          "completionTokens": 2,
                          "promptTokens": 12
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/ChatResponse"
                }
              },
              "text/event-stream": {
                "description": "Set `stream=true` for local llama.cpp deployments only. Each SSE data field is a string that encodes JSON. `chat.delta` contains `{content: string}`. `chat.completed` contains the direct final ChatResult without a data envelope. `chat.failed` contains `{error: {code, message}}` and terminates an incomplete stream. Concatenated delta content equals the final `message.content` on success. External providers return HTTP 400 `CHAT_STREAMING_UNSUPPORTED` before streaming begins. Failures before the first event use an ordinary HTTP JSON error. Client disconnection cancels generation. No event IDs, replay, automatic reconnection or resume protocol are provided. Do not retry automatically after delivered text.",
                "examples": {
                  "completed": {
                    "summary": "Final ChatResult without an ordinary data envelope",
                    "value": {
                      "data": "{\"model\":\"example-model\",\"message\":{\"role\":\"assistant\",\"content\":\"Hello.\"}}",
                      "event": "chat.completed"
                    }
                  },
                  "delta": {
                    "summary": "An incremental text fragment",
                    "value": {
                      "data": "{\"content\":\"Hello.\"}",
                      "event": "chat.delta"
                    }
                  },
                  "failed": {
                    "summary": "Terminal failure after a partial reply",
                    "value": {
                      "data": "{\"error\":{\"code\":\"CHAT_STREAM_FAILED\",\"message\":\"Chat generation did not complete.\"}}",
                      "event": "chat.failed"
                    }
                  }
                },
                "itemSchema": {
                  "$ref": "#/components/schemas/ChatServerSentEvent"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "chat-streaming-unsupported": {
                    "summary": "Streaming is currently supported for local llama.cpp deployments only. Omit stream or set it to false for an external provider.",
                    "value": {
                      "error": {
                        "code": "CHAT_STREAMING_UNSUPPORTED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Streaming is currently supported for local llama.cpp deployments only. Omit stream or set it to false for an external provider."
                      }
                    }
                  },
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  },
                  "model-required": {
                    "summary": "deploymentId is required when no deployment exists.",
                    "value": {
                      "error": {
                        "code": "MODEL_REQUIRED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "deploymentId is required when no deployment exists."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create chat",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "execute",
          "resourceScope": "*",
          "resourceType": "chat",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:836",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "Streaming is currently supported for local llama.cpp deployments only. Omit stream or set it to false for an external provider.",
            "code": "CHAT_STREAMING_UNSUPPORTED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "deploymentId is required when no deployment exists.",
            "code": "MODEL_REQUIRED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "deploymentId": "example-deployment-id",
                "maxTokens": 128,
                "messages": [
                  {
                    "content": "Reply with a short greeting.",
                    "role": "user"
                  }
                ],
                "stream": false,
                "temperature": 0.2
              },
              "method": "POST",
              "path": "/api/chat"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "deploymentId": "example-deployment-id",
                "maxTokens": 128,
                "messages": [
                  {
                    "content": "Reply with a short greeting.",
                    "role": "user"
                  }
                ],
                "stream": false,
                "temperature": 0.2
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/chat"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/chat"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Create chat. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/connections": {
      "get": {
        "description": "### Purpose\nList connections. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiConnections",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "authenticationType": "example-value",
                          "clientId": "example-value",
                          "configuration": {},
                          "connectionType": "example-value",
                          "createdAt": "2026-08-28T00:00:00Z",
                          "databaseName": "example-value",
                          "description": "example-value",
                          "enabled": true,
                          "endpoint": "example-value",
                          "host": "example-value",
                          "id": "example-value",
                          "lastTestMessage": "example-value",
                          "lastTestStatus": "example-value",
                          "lastTestedAt": "2026-08-28T00:00:00Z",
                          "name": "example-value",
                          "organizationId": "example-value",
                          "port": 1,
                          "secretStatus": {},
                          "tenantId": "example-value",
                          "tlsMode": "example-value",
                          "updatedAt": "2026-08-28T00:00:00Z",
                          "username": "example-value"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/ConnectionsDefinitionResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List connections",
        "tags": [
          "Connections and storage"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "configuration.manage"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:948",
          "owner": "Connections and storage",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "connections.integrations"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/connections"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/connections"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/connections"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List connections. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiConnectionsId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiConnectionsId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsOptions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiConnectionsId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnections",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnectionsIdTest",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "post": {
        "description": "### Purpose\nCreate connections. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiConnections",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "authenticationType": "example-value",
                    "clearSecrets": [
                      "example-value"
                    ],
                    "clientId": "example-value",
                    "configuration": {},
                    "connectionType": "example-value",
                    "databaseName": "example-value",
                    "description": "example-value",
                    "enabled": true,
                    "endpoint": "example-value",
                    "host": "example-value",
                    "name": "example-value",
                    "port": 1,
                    "secrets": {},
                    "tenantId": "example-value",
                    "tlsMode": "example-value",
                    "username": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "authenticationType": "example-value",
                    "clearSecrets": [
                      "example-value"
                    ],
                    "clientId": "example-value",
                    "configuration": {},
                    "connectionType": "example-value",
                    "databaseName": "example-value",
                    "description": "example-value",
                    "endpoint": "example-value",
                    "host": "example-value",
                    "name": "example-value",
                    "port": 1,
                    "secrets": {},
                    "tenantId": "example-value",
                    "tlsMode": "example-value",
                    "username": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/ConnectionsInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create connections",
        "tags": [
          "Connections and storage"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "configuration.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:976",
          "owner": "Connections and storage",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "connections.integrations"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "connection.created"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "authenticationType": "example-value",
                "clearSecrets": [
                  "example-value"
                ],
                "clientId": "example-value",
                "configuration": {},
                "connectionType": "example-value",
                "databaseName": "example-value",
                "description": "example-value",
                "enabled": true,
                "endpoint": "example-value",
                "host": "example-value",
                "name": "example-value",
                "port": 1,
                "secrets": {},
                "tenantId": "example-value",
                "tlsMode": "example-value",
                "username": "example-value"
              },
              "method": "POST",
              "path": "/api/connections"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "authenticationType": "example-value",
                "clearSecrets": [
                  "example-value"
                ],
                "clientId": "example-value",
                "configuration": {},
                "connectionType": "example-value",
                "databaseName": "example-value",
                "description": "example-value",
                "enabled": true,
                "endpoint": "example-value",
                "host": "example-value",
                "name": "example-value",
                "port": 1,
                "secrets": {},
                "tenantId": "example-value",
                "tlsMode": "example-value",
                "username": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/connections"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/connections"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Create connections. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiConnectionsId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsOptions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiConnectionsId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnectionsIdTest",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/connections/options": {
      "get": {
        "description": "### Purpose\nList connections options. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiConnectionsOptions",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "connectionType": "example-value",
                          "enabled": true,
                          "id": "example-value",
                          "name": "example-value"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/ConnectionsOptionResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List connections options",
        "tags": [
          "Connections and storage"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "configuration.manage"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:962",
          "owner": "Connections and storage",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "connections.integrations"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/connections/options"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/connections/options"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/connections/options"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List connections options. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiConnectionsId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiConnectionsId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnections",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnectionsIdTest",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/connections/{id}": {
      "delete": {
        "description": "### Purpose\nDelete connections. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiConnectionsId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "The id that identifies the resource selected by this operation.",
              "example": "example-id",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete connections",
        "tags": [
          "Connections and storage"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "configuration.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-id",
          "resourceType": "connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:1027",
          "owner": "Connections and storage",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "connections.integrations"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "connection.deleted"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/connections/example-id"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/connections/example-id"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/connections/example-id"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete connections. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "getapiConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsOptions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiConnectionsId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnections",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnectionsIdTest",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "get": {
        "description": "### Purpose\nGet connections. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiConnectionsId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "The id that identifies the resource selected by this operation.",
              "example": "example-id",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get connections",
        "tags": [
          "Connections and storage"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "configuration.manage"
          ],
          "resourceAction": "view",
          "resourceScope": "example-id",
          "resourceType": "connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:995",
          "owner": "Connections and storage",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "connections.integrations"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/connections/example-id"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/connections/example-id"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/connections/example-id"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get connections. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiConnectionsId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsOptions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiConnectionsId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnections",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnectionsIdTest",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "patch": {
        "description": "### Purpose\nUpdate connections. This applies only the supplied changes.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "patchapiConnectionsId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "The id that identifies the resource selected by this operation.",
              "example": "example-id",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "authenticationType": "example-value",
                    "clearSecrets": [
                      "example-value"
                    ],
                    "clientId": "example-value",
                    "configuration": {},
                    "connectionType": "example-value",
                    "databaseName": "example-value",
                    "description": "example-value",
                    "enabled": true,
                    "endpoint": "example-value",
                    "host": "example-value",
                    "name": "example-value",
                    "port": 1,
                    "secrets": {},
                    "tenantId": "example-value",
                    "tlsMode": "example-value",
                    "username": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "authenticationType": "example-value",
                    "clearSecrets": [
                      "example-value"
                    ],
                    "clientId": "example-value",
                    "configuration": {},
                    "connectionType": "example-value",
                    "databaseName": "example-value",
                    "description": "example-value",
                    "endpoint": "example-value",
                    "host": "example-value",
                    "name": "example-value",
                    "port": 1,
                    "secrets": {},
                    "tenantId": "example-value",
                    "tlsMode": "example-value",
                    "username": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/ConnectionsInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update connections",
        "tags": [
          "Connections and storage"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "configuration.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-id",
          "resourceType": "connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:1008",
          "owner": "Connections and storage",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "connections.integrations"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "connection.updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "authenticationType": "example-value",
                "clearSecrets": [
                  "example-value"
                ],
                "clientId": "example-value",
                "configuration": {},
                "connectionType": "example-value",
                "databaseName": "example-value",
                "description": "example-value",
                "enabled": true,
                "endpoint": "example-value",
                "host": "example-value",
                "name": "example-value",
                "port": 1,
                "secrets": {},
                "tenantId": "example-value",
                "tlsMode": "example-value",
                "username": "example-value"
              },
              "method": "PATCH",
              "path": "/api/connections/example-id"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "authenticationType": "example-value",
                "clearSecrets": [
                  "example-value"
                ],
                "clientId": "example-value",
                "configuration": {},
                "connectionType": "example-value",
                "databaseName": "example-value",
                "description": "example-value",
                "enabled": true,
                "endpoint": "example-value",
                "host": "example-value",
                "name": "example-value",
                "port": 1,
                "secrets": {},
                "tenantId": "example-value",
                "tlsMode": "example-value",
                "username": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PATCH",
              "path": "/api/connections/example-id"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PATCH",
              "path": "/api/connections/example-id"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Update connections. This applies only the supplied changes.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiConnectionsId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsOptions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "postapiConnections",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnectionsIdTest",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/connections/{id}/test": {
      "post": {
        "description": "### Purpose\nTest connections. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this before the related state-changing action to confirm that the proposed configuration or resource is usable.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiConnectionsIdTest",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "The id that identifies the resource selected by this operation.",
              "example": "example-id",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Validation or connectivity check completed; the response explains the current result.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Test connections",
        "tags": [
          "Connections and storage"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "configuration.manage"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-id",
          "resourceType": "connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:1040",
          "owner": "Connections and storage",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "connections.integrations"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "connection.tested"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/connections/example-id/test"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/connections/example-id/test"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/connections/example-id/test"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Test connections. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiConnectionsId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiConnectionsOptions",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "patchapiConnectionsId",
            "relationship": "next-action"
          },
          {
            "operationId": "postapiConnections",
            "relationship": "next-action"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this before the related state-changing action to confirm that the proposed configuration or resource is usable."
      }
    },
    "/api/embeddings": {
      "post": {
        "description": "### Purpose\nCreate embeddings. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiEmbeddings",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "input": "example-value",
                    "model": "example-value",
                    "prompt": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "input": "example-value",
                    "model": "example-value",
                    "prompt": "example-value"
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "input": {
                    "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                    "example": "example-value",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-arbitrary": true,
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "model": {
                    "description": "The model associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "prompt": {
                    "description": "The prompt associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": true,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "input",
                  "model",
                  "prompt"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "dimensions": 1,
                        "embeddings": [
                          [
                            1.5
                          ]
                        ],
                        "model": "example-value"
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "dimensions": {
                          "description": "The dimensions associated with this resource or operation.",
                          "example": 1,
                          "format": "int64",
                          "type": "integer",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "embeddings": {
                          "description": "The embeddings associated with this resource or operation.",
                          "example": [
                            [
                              1.5
                            ]
                          ],
                          "items": {
                            "example": [
                              1.5
                            ],
                            "items": {
                              "example": 1.5,
                              "format": "double",
                              "type": "number"
                            },
                            "type": "array"
                          },
                          "type": "array",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "model": {
                          "description": "The model associated with this resource or operation.",
                          "example": "example-value",
                          "type": "string",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "dimensions",
                        "embeddings",
                        "model"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "input-required": {
                    "summary": "input is required.",
                    "value": {
                      "error": {
                        "code": "INPUT_REQUIRED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "input is required."
                      }
                    }
                  },
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create embeddings",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "execute",
          "resourceScope": "*",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:884",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "input is required.",
            "code": "INPUT_REQUIRED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "input": "example-value",
                "model": "example-value",
                "prompt": "example-value"
              },
              "method": "POST",
              "path": "/api/embeddings"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "input": "example-value",
                "model": "example-value",
                "prompt": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/embeddings"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/embeddings"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Create embeddings. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/model-providers/connections": {
      "get": {
        "description": "### Purpose\nList model providers connections. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiModelProvidersConnections",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "baseUrl": "example-value",
                          "configuration": "example-value",
                          "createdAt": "2026-08-28T00:00:00Z",
                          "displayName": "example-value",
                          "enabled": true,
                          "id": "example-value",
                          "organizationId": "example-value",
                          "providerType": "example-value",
                          "updatedAt": "2026-08-28T00:00:00Z"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/DomainModelConnectionResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List model providers connections",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:589",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/model-providers/connections"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/model-providers/connections"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/model-providers/connections"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List model providers connections. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeploymentsDeploymentId",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "post": {
        "description": "### Purpose\nConnections model providers. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiModelProvidersConnections",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "baseUrl": "example-value",
                    "configuration": {},
                    "credentials": {
                      "apiKey": "example-value",
                      "awsAccessKeyId": "example-value",
                      "awsSecretAccessKey": "example-value",
                      "awsSessionToken": "example-value",
                      "headers": {}
                    },
                    "displayName": "example-value",
                    "enabled": true,
                    "providerType": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "baseUrl": "example-value",
                    "configuration": {},
                    "credentials": {},
                    "displayName": "example-value",
                    "providerType": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/ModelsConnectionInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Connections model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "model.connection.create",
            "models.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:612",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.connection.created"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "baseUrl": "example-value",
                "configuration": {},
                "credentials": {
                  "apiKey": "example-value",
                  "awsAccessKeyId": "example-value",
                  "awsSecretAccessKey": "example-value",
                  "awsSessionToken": "example-value",
                  "headers": {}
                },
                "displayName": "example-value",
                "enabled": true,
                "providerType": "example-value"
              },
              "method": "POST",
              "path": "/api/model-providers/connections"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "baseUrl": "example-value",
                "configuration": {},
                "credentials": {
                  "apiKey": "example-value",
                  "awsAccessKeyId": "example-value",
                  "awsSecretAccessKey": "example-value",
                  "awsSessionToken": "example-value",
                  "headers": {}
                },
                "displayName": "example-value",
                "enabled": true,
                "providerType": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/model-providers/connections"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/model-providers/connections"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Connections model providers. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/model-providers/connections/{connectionId}": {
      "delete": {
        "description": "### Purpose\nDelete model providers. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiModelProvidersConnectionsConnectionId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "model.connection.delete",
            "models.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:665",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.connection.deleted"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete model providers. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeploymentsDeploymentId",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "get": {
        "description": "### Purpose\nGet model providers. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiModelProvidersConnectionsConnectionId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:630",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get model providers. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeploymentsDeploymentId",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "patch": {
        "description": "### Purpose\nUpdate model providers. This applies only the supplied changes.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "patchapiModelProvidersConnectionsConnectionId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "baseUrl": "example-value",
                    "configuration": {},
                    "credentials": {
                      "apiKey": "example-value",
                      "awsAccessKeyId": "example-value",
                      "awsSecretAccessKey": "example-value",
                      "awsSessionToken": "example-value",
                      "headers": {}
                    },
                    "displayName": "example-value",
                    "enabled": true,
                    "providerType": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "baseUrl": "example-value",
                    "configuration": {},
                    "credentials": {},
                    "displayName": "example-value",
                    "providerType": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/ModelsConnectionInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "model.connection.update",
            "models.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:647",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.connection.updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "baseUrl": "example-value",
                "configuration": {},
                "credentials": {
                  "apiKey": "example-value",
                  "awsAccessKeyId": "example-value",
                  "awsSecretAccessKey": "example-value",
                  "awsSessionToken": "example-value",
                  "headers": {}
                },
                "displayName": "example-value",
                "enabled": true,
                "providerType": "example-value"
              },
              "method": "PATCH",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "baseUrl": "example-value",
                "configuration": {},
                "credentials": {
                  "apiKey": "example-value",
                  "awsAccessKeyId": "example-value",
                  "awsSecretAccessKey": "example-value",
                  "awsSessionToken": "example-value",
                  "headers": {}
                },
                "displayName": "example-value",
                "enabled": true,
                "providerType": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PATCH",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PATCH",
              "path": "/api/model-providers/connections/example-connectionId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Update model providers. This applies only the supplied changes.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/model-providers/connections/{connectionId}/deployments": {
      "post": {
        "description": "### Purpose\nDeployments model providers. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiModelProvidersConnectionsConnectionIdDeployments",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "capabilities": {},
                    "configuration": {},
                    "displayName": "example-value",
                    "enabled": true,
                    "pinnedRevision": "example-value",
                    "preload": true,
                    "providerModelId": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "capabilities": {},
                    "configuration": {},
                    "displayName": "example-value",
                    "pinnedRevision": "example-value",
                    "providerModelId": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/ModelsDeploymentInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Deployments model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "model.deployment.create",
            "models.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:748",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.deployment.created"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "capabilities": {},
                "configuration": {},
                "displayName": "example-value",
                "enabled": true,
                "pinnedRevision": "example-value",
                "preload": true,
                "providerModelId": "example-value"
              },
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/deployments"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "capabilities": {},
                "configuration": {},
                "displayName": "example-value",
                "enabled": true,
                "pinnedRevision": "example-value",
                "preload": true,
                "providerModelId": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/deployments"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/deployments"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Deployments model providers. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/model-providers/connections/{connectionId}/models": {
      "get": {
        "description": "### Purpose\nGet model providers models. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get model providers models",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage",
            "models.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:689",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/model-providers/connections/example-connectionId/models"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/model-providers/connections/example-connectionId/models"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/model-providers/connections/example-connectionId/models"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get model providers models. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeploymentsDeploymentId",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/model-providers/connections/{connectionId}/models/discover": {
      "post": {
        "description": "### Purpose\nModels model providers. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiModelProvidersConnectionsConnectionIdModelsDiscover",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Models model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:690",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/models/discover"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/models/discover"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/models/discover"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Models model providers. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/model-providers/connections/{connectionId}/models/import": {
      "post": {
        "description": "### Purpose\nModels model providers. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiModelProvidersConnectionsConnectionIdModelsImport",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "models": [
                      {
                        "capabilities": {},
                        "configuration": {},
                        "displayName": "example-value",
                        "enabled": true,
                        "pinnedRevision": "example-value",
                        "preload": true,
                        "providerModelId": "example-value"
                      }
                    ]
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "models": [
                      {
                        "capabilities": {},
                        "configuration": {},
                        "displayName": "example-value",
                        "pinnedRevision": "example-value",
                        "providerModelId": "example-value"
                      }
                    ]
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "models": {
                    "description": "The models associated with this resource or operation.",
                    "example": [
                      "example-value"
                    ],
                    "items": {
                      "$ref": "#/components/schemas/ModelsDeploymentInputRequest"
                    },
                    "type": "array",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "models"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        "example-value"
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                        "example": "example-value",
                        "x-punaha-arbitrary": true
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Models model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:691",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.deployment.created"
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "models": [
                  {
                    "capabilities": {},
                    "configuration": {},
                    "displayName": "example-value",
                    "enabled": true,
                    "pinnedRevision": "example-value",
                    "preload": true,
                    "providerModelId": "example-value"
                  }
                ]
              },
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/models/import"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "models": [
                  {
                    "capabilities": {},
                    "configuration": {},
                    "displayName": "example-value",
                    "enabled": true,
                    "pinnedRevision": "example-value",
                    "preload": true,
                    "providerModelId": "example-value"
                  }
                ]
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/models/import"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/models/import"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Models model providers. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/model-providers/connections/{connectionId}/test": {
      "post": {
        "description": "### Purpose\nTest model providers. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this before the related state-changing action to confirm that the proposed configuration or resource is usable.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiModelProvidersConnectionsConnectionIdTest",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The connection id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "description": "The connection id that identifies the resource selected by this operation.",
              "example": "example-connectionid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "connected": true
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "connected": {
                          "description": "The connected associated with this resource or operation.",
                          "example": true,
                          "type": "boolean",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "connected"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Validation or connectivity check completed; the response explains the current result.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Test model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-connectionid",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:677",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.connection.tested"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/test"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/test"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/model-providers/connections/example-connectionId/test"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Test model providers. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this before the related state-changing action to confirm that the proposed configuration or resource is usable."
      }
    },
    "/api/model-providers/deployments": {
      "get": {
        "description": "### Purpose\nList model providers deployments. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiModelProvidersDeployments",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "capabilities": "example-value",
                          "configuration": "example-value",
                          "connectionId": "example-value",
                          "createdAt": "2026-08-28T00:00:00Z",
                          "displayName": "example-value",
                          "enabled": true,
                          "id": "example-value",
                          "organizationId": "example-value",
                          "pinnedRevision": "example-value",
                          "preload": true,
                          "providerModelId": "example-value",
                          "updatedAt": "2026-08-28T00:00:00Z"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/DomainModelDeploymentResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List model providers deployments",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:715",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/model-providers/deployments"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/model-providers/deployments"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/model-providers/deployments"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List model providers deployments. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeploymentsDeploymentId",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/model-providers/deployments/sync-local": {
      "post": {
        "description": "### Purpose\nSync Local model providers. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiModelProvidersDeploymentsSyncLocal",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "serverId",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "example-serverid",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Sync Local model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:733",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/model-providers/deployments/sync-local"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/model-providers/deployments/sync-local"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/model-providers/deployments/sync-local"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Sync Local model providers. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/model-providers/deployments/{deploymentId}": {
      "delete": {
        "description": "### Purpose\nDelete model providers. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The deployment id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "deploymentId",
            "required": true,
            "schema": {
              "description": "The deployment id that identifies the resource selected by this operation.",
              "example": "example-deploymentid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "model.deployment.delete",
            "models.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-deploymentid",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:853",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.deployment.deleted"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete model providers. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeploymentsDeploymentId",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "get": {
        "description": "### Purpose\nGet model providers. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiModelProvidersDeploymentsDeploymentId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The deployment id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "deploymentId",
            "required": true,
            "schema": {
              "description": "The deployment id that identifies the resource selected by this operation.",
              "example": "example-deploymentid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-deploymentid",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:766",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get model providers. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "patch": {
        "description": "### Purpose\nUpdate model providers. This applies only the supplied changes.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "patchapiModelProvidersDeploymentsDeploymentId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The deployment id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "deploymentId",
            "required": true,
            "schema": {
              "description": "The deployment id that identifies the resource selected by this operation.",
              "example": "example-deploymentid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "capabilities": {},
                    "configuration": {},
                    "displayName": "example-value",
                    "enabled": true,
                    "pinnedRevision": "example-value",
                    "preload": true,
                    "providerModelId": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "capabilities": {},
                    "configuration": {},
                    "displayName": "example-value",
                    "pinnedRevision": "example-value",
                    "providerModelId": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/ModelsDeploymentInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "model.deployment.update",
            "models.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-deploymentid",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:783",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.deployment.updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "capabilities": {},
                "configuration": {},
                "displayName": "example-value",
                "enabled": true,
                "pinnedRevision": "example-value",
                "preload": true,
                "providerModelId": "example-value"
              },
              "method": "PATCH",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "capabilities": {},
                "configuration": {},
                "displayName": "example-value",
                "enabled": true,
                "pinnedRevision": "example-value",
                "preload": true,
                "providerModelId": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PATCH",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PATCH",
              "path": "/api/model-providers/deployments/example-deploymentId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Update model providers. This applies only the supplied changes.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/model-providers/deployments/{deploymentId}/memory": {
      "put": {
        "description": "### Purpose\nMemory model providers. This replaces or sets the selected state using the full supplied value.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "putapiModelProvidersDeploymentsDeploymentIdMemory",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The deployment id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "deploymentId",
            "required": true,
            "schema": {
              "description": "The deployment id that identifies the resource selected by this operation.",
              "example": "example-deploymentid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "loaded": true,
                    "serverId": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "serverId": "example-value"
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "loaded": {
                    "anyOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The loaded associated with this resource or operation.",
                    "example": true,
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-nullable": true,
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "serverId": {
                    "description": "The server id associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "serverId"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  },
                  "memory-setting-required": {
                    "summary": "Choose whether the model should be loaded in memory now.",
                    "value": {
                      "error": {
                        "code": "MEMORY_SETTING_REQUIRED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Choose whether the model should be loaded in memory now."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Memory model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-deploymentid",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:825",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.deployment.memory_updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "Choose whether the model should be loaded in memory now.",
            "code": "MEMORY_SETTING_REQUIRED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "loaded": true,
                "serverId": "example-value"
              },
              "method": "PUT",
              "path": "/api/model-providers/deployments/example-deploymentId/memory"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "loaded": true,
                "serverId": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PUT",
              "path": "/api/model-providers/deployments/example-deploymentId/memory"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PUT",
              "path": "/api/model-providers/deployments/example-deploymentId/memory"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Memory model providers. This replaces or sets the selected state using the full supplied value.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/model-providers/deployments/{deploymentId}/preload": {
      "put": {
        "description": "### Purpose\nPreload model providers. This replaces or sets the selected state using the full supplied value.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "putapiModelProvidersDeploymentsDeploymentIdPreload",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The deployment id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "deploymentId",
            "required": true,
            "schema": {
              "description": "The deployment id that identifies the resource selected by this operation.",
              "example": "example-deploymentid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "preload": true
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {}
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "preload": {
                    "anyOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The preload associated with this resource or operation.",
                    "example": true,
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-nullable": true,
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  },
                  "preload-setting-required": {
                    "summary": "Choose whether the model should load at service startup.",
                    "value": {
                      "error": {
                        "code": "PRELOAD_SETTING_REQUIRED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Choose whether the model should load at service startup."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Preload model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-deploymentid",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:801",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.deployment.preload_updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "Choose whether the model should load at service startup.",
            "code": "PRELOAD_SETTING_REQUIRED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "preload": true
              },
              "method": "PUT",
              "path": "/api/model-providers/deployments/example-deploymentId/preload"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "preload": true
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PUT",
              "path": "/api/model-providers/deployments/example-deploymentId/preload"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PUT",
              "path": "/api/model-providers/deployments/example-deploymentId/preload"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Preload model providers. This replaces or sets the selected state using the full supplied value.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/model-providers/deployments/{deploymentId}/refresh-revision": {
      "post": {
        "description": "### Purpose\nRefresh Revision model providers. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiModelProvidersDeploymentsDeploymentIdRefreshRevision",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The deployment id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "deploymentId",
            "required": true,
            "schema": {
              "description": "The deployment id that identifies the resource selected by this operation.",
              "example": "example-deploymentid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Refresh Revision model providers",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "example-deploymentid",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:865",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "model.deployment.revision_refreshed"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/model-providers/deployments/example-deploymentId/refresh-revision"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/model-providers/deployments/example-deploymentId/refresh-revision"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/model-providers/deployments/example-deploymentId/refresh-revision"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Refresh Revision model providers. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/model-providers/types": {
      "get": {
        "description": "### Purpose\nList model providers types. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiModelProvidersTypes",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {}
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        {}
                      ],
                      "items": {
                        "additionalProperties": true,
                        "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                        "type": "object",
                        "x-punaha-arbitrary": true
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List model providers types",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "model_connection",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:422",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "models.external"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector",
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "May contact the configured external or local provider when the action requires discovery, validation, inference, or connectivity testing.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/model-providers/types"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/model-providers/types"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/model-providers/types"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List model providers types. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/models": {
      "get": {
        "description": "### Purpose\nList models. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiModels",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List models",
        "tags": [
          "Models and inference"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "model_deployment",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:819",
          "owner": "Models and inference",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "inference"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/models"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/models"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/models"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List models. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiModelProvidersConnectionsConnectionId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiModelProvidersDeploymentsDeploymentId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiModelProvidersConnections",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionId",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersConnectionsConnectionIdModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiModelProvidersDeployments",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases": {
      "get": {
        "description": "### Purpose\nList vector databases. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabases",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value",
                      "pagination": {}
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "pagination": {
                      "$ref": "#/components/schemas/Pagination",
                      "description": "The pagination associated with this resource or operation.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data",
                    "pagination"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_databases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:36",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List vector databases. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesIngestionJobs",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "post": {
        "description": "### Purpose\nCreate vector databases. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiVectorDatabases",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "configuration": {
                      "advanced": {
                        "topK": 1
                      },
                      "embeddingModel": {
                        "available": true,
                        "contextTokens": 1,
                        "dimensions": 1,
                        "id": "example-value",
                        "local": true,
                        "name": "example-value",
                        "provider": "example-value",
                        "runtime": "example-value",
                        "status": "example-value"
                      },
                      "methodologies": [
                        {
                          "enabled": true,
                          "id": "example-value",
                          "settings": {
                            "childChunkSize": 1,
                            "chunkSize": 1,
                            "entityTypes": [
                              "example-value"
                            ],
                            "generationInstructions": "example-value",
                            "overlap": 1,
                            "parentChunkSize": 1,
                            "questionsPerSection": 1,
                            "summaryDetail": "example-value"
                          }
                        }
                      ],
                      "processingModel": {
                        "deploymentId": "example-value"
                      }
                    },
                    "description": "example-value",
                    "name": "example-value",
                    "title": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "configuration": {
                      "advanced": {
                        "topK": 1
                      },
                      "embeddingModel": {
                        "available": true,
                        "dimensions": 1,
                        "id": "example-value",
                        "local": true,
                        "name": "example-value",
                        "provider": "example-value",
                        "runtime": "example-value",
                        "status": "example-value"
                      },
                      "methodologies": [
                        {
                          "enabled": true,
                          "id": "example-value"
                        }
                      ]
                    },
                    "description": "example-value",
                    "name": "example-value",
                    "title": "example-value"
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "configuration": {
                    "$ref": "#/components/schemas/DomainKnowledgeConfigurationRequest",
                    "description": "The configuration associated with this resource or operation.",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "description": {
                    "description": "The description associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "name": {
                    "description": "The name associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "title": {
                    "description": "The title associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "configuration",
                  "description",
                  "name",
                  "title"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_database.create",
            "vector_databases.create"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:162",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "vector_database.created"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "configuration": {
                  "advanced": {
                    "topK": 1
                  },
                  "embeddingModel": {
                    "available": true,
                    "contextTokens": 1,
                    "dimensions": 1,
                    "id": "example-value",
                    "local": true,
                    "name": "example-value",
                    "provider": "example-value",
                    "runtime": "example-value",
                    "status": "example-value"
                  },
                  "methodologies": [
                    {
                      "enabled": true,
                      "id": "example-value",
                      "settings": {
                        "childChunkSize": 1,
                        "chunkSize": 1,
                        "entityTypes": [
                          "example-value"
                        ],
                        "generationInstructions": "example-value",
                        "overlap": 1,
                        "parentChunkSize": 1,
                        "questionsPerSection": 1,
                        "summaryDetail": "example-value"
                      }
                    }
                  ],
                  "processingModel": {
                    "deploymentId": "example-value"
                  }
                },
                "description": "example-value",
                "name": "example-value",
                "title": "example-value"
              },
              "method": "POST",
              "path": "/api/vector-databases"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "configuration": {
                  "advanced": {
                    "topK": 1
                  },
                  "embeddingModel": {
                    "available": true,
                    "contextTokens": 1,
                    "dimensions": 1,
                    "id": "example-value",
                    "local": true,
                    "name": "example-value",
                    "provider": "example-value",
                    "runtime": "example-value",
                    "status": "example-value"
                  },
                  "methodologies": [
                    {
                      "enabled": true,
                      "id": "example-value",
                      "settings": {
                        "childChunkSize": 1,
                        "chunkSize": 1,
                        "entityTypes": [
                          "example-value"
                        ],
                        "generationInstructions": "example-value",
                        "overlap": 1,
                        "parentChunkSize": 1,
                        "questionsPerSection": 1,
                        "summaryDetail": "example-value"
                      }
                    }
                  ],
                  "processingModel": {
                    "deploymentId": "example-value"
                  }
                },
                "description": "example-value",
                "name": "example-value",
                "title": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/vector-databases"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/vector-databases"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Create vector databases. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/vector-databases/address-availability": {
      "get": {
        "description": "### Purpose\nList vector databases address availability. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesAddressAvailability",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "name",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "Example Name",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "available": true
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "available": {
                          "description": "The available associated with this resource or operation.",
                          "example": true,
                          "type": "boolean",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "available"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List vector databases address availability",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_databases.create"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:23",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/address-availability"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/address-availability"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/address-availability"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List vector databases address availability. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesIngestionJobs",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases/embedding-models": {
      "get": {
        "description": "### Purpose\nList vector databases embedding models. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesEmbeddingModels",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "catalogue": {
                        "modelSizes": {},
                        "refreshing": true,
                        "state": "example-value",
                        "updatedAt": "2026-08-28T00:00:00Z"
                      },
                      "data": [
                        {
                          "available": true,
                          "contextTokens": 1,
                          "default": true,
                          "dimensions": 1,
                          "id": "example-value",
                          "local": true,
                          "name": "example-value",
                          "provider": "example-value",
                          "runtime": "example-value",
                          "sizeBytes": 1,
                          "status": "example-value"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "catalogue": {
                      "$ref": "#/components/schemas/LlamacppCatalogueStatusResponse",
                      "description": "The catalogue associated with this resource or operation.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/VectorEmbeddingModelResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "catalogue",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List vector databases embedding models",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "models.read",
            "vector_databases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:66",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/embedding-models"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/embedding-models"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/embedding-models"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List vector databases embedding models. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesIngestionJobs",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases/ingestion-jobs": {
      "get": {
        "description": "### Purpose\nList vector databases ingestion jobs. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesIngestionJobs",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "databaseName",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "Example DatabaseName",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "attempt": 1,
                          "completedSections": 1,
                          "createdAt": "2026-08-28T00:00:00Z",
                          "createdBy": "example-value",
                          "databaseName": "example-value",
                          "documentId": "example-value",
                          "errorCode": "example-value",
                          "errorMessage": "example-value",
                          "fileName": "example-value",
                          "id": "example-value",
                          "maximumAttempts": 1,
                          "organizationId": "example-value",
                          "priority": "example-value",
                          "processing": "example-value",
                          "processingOptions": {
                            "gpuUtilizationTargetPercent": 1,
                            "maxParallelSections": 1
                          },
                          "progress": 1,
                          "serverId": "example-value",
                          "serverName": "example-value",
                          "stage": "example-value",
                          "status": "example-value",
                          "targetServer": "example-value",
                          "targetServerId": "example-value",
                          "totalSections": 1,
                          "updatedAt": "2026-08-28T00:00:00Z"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/DomainIngestionJobResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List vector databases ingestion jobs",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "documents.read",
            "vector_databases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:95",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List vector databases ingestion jobs. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases/ingestion-jobs/{jobId}": {
      "delete": {
        "description": "### Purpose\nDelete vector databases. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The job id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "jobId",
            "required": true,
            "schema": {
              "description": "The job id that identifies the resource selected by this operation.",
              "example": "example-jobid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  },
                  "resource-access-denied": {
                    "summary": "You do not have permission to cancel and delete this document.",
                    "value": {
                      "error": {
                        "code": "RESOURCE_ACCESS_DENIED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "You do not have permission to cancel and delete this document."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "documents.delete",
            "documents.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "",
          "resourceType": "document",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:140",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "document.ingestion_cancelled_deleted"
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "You do not have permission to cancel and delete this document.",
            "code": "RESOURCE_ACCESS_DENIED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete vector databases. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesIngestionJobs",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "get": {
        "description": "### Purpose\nGet vector databases. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesIngestionJobsJobId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The job id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "jobId",
            "required": true,
            "schema": {
              "description": "The job id that identifies the resource selected by this operation.",
              "example": "example-jobid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  },
                  "resource-access-denied": {
                    "summary": "You do not have access to this document processing job.",
                    "value": {
                      "error": {
                        "code": "RESOURCE_ACCESS_DENIED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "You do not have access to this document processing job."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "documents.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "document",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:109",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "You do not have access to this document processing job.",
            "code": "RESOURCE_ACCESS_DENIED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get vector databases. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases/ingestion-jobs/{jobId}/servers": {
      "get": {
        "description": "### Purpose\nGet vector databases servers. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesIngestionJobsJobIdServers",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The job id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "jobId",
            "required": true,
            "schema": {
              "description": "The job id that identifies the resource selected by this operation.",
              "example": "example-jobid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "document-task-not-found": {
                    "summary": "The document task was not found in this tenant.",
                    "value": {
                      "error": {
                        "code": "DOCUMENT_TASK_NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The document task was not found in this tenant."
                      }
                    }
                  },
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  },
                  "document-processing-unavailable": {
                    "summary": "The document processing service is unavailable.",
                    "value": {
                      "error": {
                        "code": "DOCUMENT_PROCESSING_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "The document processing service is unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get vector databases servers",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "documents.read",
            "operations.manage"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "document",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "operations.go:18",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The document task was not found in this tenant.",
            "code": "DOCUMENT_TASK_NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          },
          {
            "cause": "The document processing service is unavailable.",
            "code": "DOCUMENT_PROCESSING_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId/servers"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId/servers"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/ingestion-jobs/example-jobId/servers"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get vector databases servers. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases/methodologies": {
      "get": {
        "description": "### Purpose\nList vector databases methodologies. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesMethodologies",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "defaultSelected": true,
                          "defaultSettings": {
                            "childChunkSize": 1,
                            "chunkSize": 1,
                            "entityTypes": [
                              "example-value"
                            ],
                            "generationInstructions": "example-value",
                            "overlap": 1,
                            "parentChunkSize": 1,
                            "questionsPerSection": 1,
                            "summaryDetail": "example-value"
                          },
                          "description": "example-value",
                          "enabled": true,
                          "id": "example-value",
                          "name": "example-value",
                          "requiresProcessingModel": true
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/VectorMethodologyDefinitionResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List vector databases methodologies",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_databases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:59",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/methodologies"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/methodologies"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/methodologies"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List vector databases methodologies. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases/upload-policy": {
      "get": {
        "description": "### Purpose\nList vector databases upload policy. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesUploadPolicy",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "allowedExtensions": [
                          "example-value"
                        ],
                        "maximumFileSizeBytes": 1,
                        "maximumFileSizeMb": 1,
                        "maximumFilesPerUpload": 1
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "allowedExtensions": {
                          "description": "The allowed extensions associated with this resource or operation.",
                          "example": [
                            "example-value"
                          ],
                          "items": {
                            "example": "example-value",
                            "type": "string"
                          },
                          "type": "array",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "maximumFileSizeBytes": {
                          "description": "The maximum file size bytes associated with this resource or operation.",
                          "example": 1,
                          "format": "int64",
                          "type": "integer",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "maximumFileSizeMb": {
                          "description": "The maximum file size mb associated with this resource or operation.",
                          "example": 1,
                          "format": "int64",
                          "type": "integer",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "maximumFilesPerUpload": {
                          "description": "The maximum files per upload associated with this resource or operation.",
                          "example": 1,
                          "format": "int64",
                          "type": "integer",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "allowedExtensions",
                        "maximumFileSizeBytes",
                        "maximumFileSizeMb",
                        "maximumFilesPerUpload"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List vector databases upload policy",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_databases.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:82",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/upload-policy"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/upload-policy"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/upload-policy"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List vector databases upload policy. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/vector-databases/{name}": {
      "delete": {
        "description": "### Purpose\nDelete vector databases. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiVectorDatabasesName",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The name that identifies the resource selected by this operation.",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "The name that identifies the resource selected by this operation.",
              "example": "example-name",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_database.delete",
            "vector_databases.delete"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-name",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:206",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "vector_database.deleted"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/vector-databases/example-name"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/vector-databases/example-name"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/vector-databases/example-name"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete vector databases. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesIngestionJobs",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "patch": {
        "description": "### Purpose\nUpdate vector databases. This applies only the supplied changes.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "patchapiVectorDatabasesName",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The name that identifies the resource selected by this operation.",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "The name that identifies the resource selected by this operation.",
              "example": "example-name",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "description": "example-value",
                    "title": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {}
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "description": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The description associated with this resource or operation.",
                    "example": "example-value",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-nullable": true,
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "title": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The title associated with this resource or operation.",
                    "example": "example-value",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-nullable": true,
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_database.update",
            "vector_databases.update"
          ],
          "resourceAction": "update",
          "resourceScope": "example-name",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:185",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "vector_database.updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "description": "example-value",
                "title": "example-value"
              },
              "method": "PATCH",
              "path": "/api/vector-databases/example-name"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "description": "example-value",
                "title": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PATCH",
              "path": "/api/vector-databases/example-name"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PATCH",
              "path": "/api/vector-databases/example-name"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Update vector databases. This applies only the supplied changes.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/vector-databases/{name}/files": {
      "get": {
        "description": "### Purpose\nGet vector databases files. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiVectorDatabasesNameFiles",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The name that identifies the resource selected by this operation.",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "The name that identifies the resource selected by this operation.",
              "example": "example-name",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "createdAt": "2026-08-28T00:00:00Z",
                          "databaseName": "example-value",
                          "description": "example-value",
                          "fileName": "example-value",
                          "id": "example-value",
                          "metadata": "example-value",
                          "mimeType": "example-value",
                          "organizationId": "example-value",
                          "sectionCount": 1,
                          "sizeBytes": 1,
                          "status": "example-value",
                          "title": "example-value",
                          "toc": [
                            {
                              "level": 1,
                              "title": "example-value"
                            }
                          ],
                          "updatedAt": "2026-08-28T00:00:00Z"
                        }
                      ],
                      "pagination": {}
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/DomainDocumentResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "pagination": {
                      "$ref": "#/components/schemas/Pagination",
                      "description": "The pagination associated with this resource or operation.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data",
                    "pagination"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get vector databases files",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "documents.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "document",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:239",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/vector-databases/example-name/files"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/vector-databases/example-name/files"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/vector-databases/example-name/files"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get vector databases files. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "post": {
        "description": "### Purpose\nFiles vector databases. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiVectorDatabasesNameFiles",
        "parameters": [
          {
            "description": "The content type associated with this resource or operation.",
            "in": "header",
            "name": "content-type",
            "required": false,
            "schema": {
              "description": "The content type associated with this resource or operation.",
              "example": "example-value",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "Treat as sensitive. Do not place real values in examples or logs; apply the Product redaction and access controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": true,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          },
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The name that identifies the resource selected by this operation.",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "The name that identifies the resource selected by this operation.",
              "example": "example-name",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "metadata": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {}
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "metadata": {
                    "description": "The metadata associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        "example-value"
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                        "example": "example-value",
                        "x-punaha-arbitrary": true
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The request was accepted for background processing; use the documented status operation to monitor it.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-multipart": {
                    "summary": "The documented operation condition occurred.",
                    "value": {
                      "error": {
                        "code": "INVALID_MULTIPART",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The documented operation condition occurred."
                      }
                    }
                  },
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  },
                  "too-many-files": {
                    "summary": "Too many documents were selected for one upload.",
                    "value": {
                      "error": {
                        "code": "TOO_MANY_FILES",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Too many documents were selected for one upload."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Files vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "document.create",
            "documents.create"
          ],
          "resourceAction": "create",
          "resourceScope": "example-name",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:258",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "document.uploaded"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The documented operation condition occurred.",
            "code": "INVALID_MULTIPART",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "Too many documents were selected for one upload.",
            "code": "TOO_MANY_FILES",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "metadata": "example-value"
              },
              "method": "POST",
              "path": "/api/vector-databases/example-name/files"
            },
            "response": {
              "status": "202"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "metadata": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/vector-databases/example-name/files"
            },
            "response": {
              "status": "202"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/vector-databases/example-name/files"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Files vector databases. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/vector-databases/{name}/files/{fileId}": {
      "delete": {
        "description": "### Purpose\nDelete vector databases. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiVectorDatabasesNameFilesFileId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The file id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "fileId",
            "required": true,
            "schema": {
              "description": "The file id that identifies the resource selected by this operation.",
              "example": "example-fileid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The name that identifies the resource selected by this operation.",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "The name that identifies the resource selected by this operation.",
              "example": "example-name",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "document.delete",
            "documents.delete",
            "documents.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-fileid",
          "resourceType": "document",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:277",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "document.deleted"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/vector-databases/example-name/files/example-fileId"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/vector-databases/example-name/files/example-fileId"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/vector-databases/example-name/files/example-fileId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete vector databases. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesIngestionJobs",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "patch": {
        "description": "### Purpose\nFiles vector databases. This applies only the supplied changes.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "patchapiVectorDatabasesNameFilesFileId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The file id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "fileId",
            "required": true,
            "schema": {
              "description": "The file id that identifies the resource selected by this operation.",
              "example": "example-fileid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The name that identifies the resource selected by this operation.",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "The name that identifies the resource selected by this operation.",
              "example": "example-name",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "description": "A fictitious policy used in API examples.",
                    "title": "Example policy",
                    "toc": [
                      {
                        "level": 1,
                        "title": "example-value"
                      }
                    ]
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {}
                }
              },
              "schema": {
                "additionalProperties": false,
                "description": "A partial update. Supply at least one documented property; omitted properties remain unchanged.",
                "minProperties": 1,
                "properties": {
                  "description": {
                    "description": "Document summary used to explain the source content.",
                    "example": "A fictitious policy used in API examples.",
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "Omission retains the description; an empty string clears it; null is not a documented value.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable after upload.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  },
                  "title": {
                    "description": "Human-readable document title used in knowledge results.",
                    "example": "Example policy",
                    "minLength": 1,
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "Omission retains the title. An empty string is ignored; null is not a documented value.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable after upload.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  },
                  "toc": {
                    "description": "Replacement table of contents extracted from or assigned to the document.",
                    "example": [
                      {
                        "level": 1,
                        "title": "Introduction"
                      }
                    ],
                    "items": {
                      "$ref": "#/components/schemas/DomainTOCEntryResponse"
                    },
                    "type": "array",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "Omission retains the table of contents. An empty array clears it; null is ignored and should not be sent.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable after upload; supplied entries replace the current table of contents.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Files vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "document.update",
            "documents.manage",
            "documents.update"
          ],
          "resourceAction": "update",
          "resourceScope": "example-fileid",
          "resourceType": "document",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:259",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "document.updated"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "description": "A fictitious policy used in API examples.",
                "title": "Example policy",
                "toc": [
                  {
                    "level": 1,
                    "title": "example-value"
                  }
                ]
              },
              "method": "PATCH",
              "path": "/api/vector-databases/example-name/files/example-fileId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "description": "A fictitious policy used in API examples.",
                "title": "Example policy",
                "toc": [
                  {
                    "level": 1,
                    "title": "example-value"
                  }
                ]
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PATCH",
              "path": "/api/vector-databases/example-name/files/example-fileId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PATCH",
              "path": "/api/vector-databases/example-name/files/example-fileId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Files vector databases. This applies only the supplied changes.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/vector-databases/{name}/query": {
      "post": {
        "description": "### Purpose\nQuery vector databases. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiVectorDatabasesNameQuery",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The name that identifies the resource selected by this operation.",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "The name that identifies the resource selected by this operation.",
              "example": "example-name",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "limit": 1,
                    "query": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "limit": 1,
                    "query": "example-value"
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "limit": {
                    "description": "The limit associated with this resource or operation.",
                    "example": 1,
                    "format": "int64",
                    "type": "integer",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "query": {
                    "description": "The query associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "limit",
                  "query"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "query": "example-value",
                        "results": [
                          {
                            "content": "example-value",
                            "distance": 1.5,
                            "documentId": "example-value",
                            "id": "example-value",
                            "metadata": {},
                            "score": 1.5,
                            "title": "example-value"
                          }
                        ]
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "query": {
                          "description": "The query associated with this resource or operation.",
                          "example": "example-value",
                          "type": "string",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "results": {
                          "description": "The results associated with this resource or operation.",
                          "example": [
                            "example-value"
                          ],
                          "items": {
                            "$ref": "#/components/schemas/VectorSearchResultResponse"
                          },
                          "type": "array",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "query",
                        "results"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Query vector databases",
        "tags": [
          "Knowledge and documents"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "vector_databases.execute",
            "vector_databases.read"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-name",
          "resourceType": "vector_database",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "vector_models.go:218",
          "owner": "Knowledge and documents",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "vector.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "vector"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "limit": 1,
                "query": "example-value"
              },
              "method": "POST",
              "path": "/api/vector-databases/example-name/query"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "limit": 1,
                "query": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/vector-databases/example-name/query"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/vector-databases/example-name/query"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Query vector databases. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiVectorDatabasesIngestionJobsJobId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesName",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiVectorDatabasesNameFilesFileId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiVectorDatabases",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesAddressAvailability",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiVectorDatabasesEmbeddingModels",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/workflows": {
      "get": {
        "description": "### Purpose\nList workflows. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflows",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "access": {},
                          "createdAt": "2026-08-28T00:00:00Z",
                          "definition": "example-value",
                          "description": "example-value",
                          "displayName": "example-value",
                          "draftValid": true,
                          "folderId": "example-value",
                          "id": "example-value",
                          "lastRun": {
                            "completedAt": "2026-08-28T00:00:00Z",
                            "createdAt": "2026-08-28T00:00:00Z",
                            "createdBy": "example-value",
                            "errorCode": "example-value",
                            "errorMessage": "example-value",
                            "id": "example-value",
                            "input": "example-value",
                            "isDraftTest": true,
                            "organizationId": "example-value",
                            "output": "example-value",
                            "priority": "example-value",
                            "resumeAt": "2026-08-28T00:00:00Z",
                            "runKind": "example-value",
                            "serverId": "example-value",
                            "startedAt": "2026-08-28T00:00:00Z",
                            "state": "example-value",
                            "stateRevision": 1,
                            "status": "example-value",
                            "threadId": "example-value",
                            "updatedAt": "2026-08-28T00:00:00Z",
                            "waitKind": "example-value",
                            "waitingNodeId": "example-value",
                            "workflowId": "example-value",
                            "workflowVersion": 1
                          },
                          "organizationId": "example-value",
                          "publishedVersion": 1,
                          "slug": "example-value",
                          "status": "example-value",
                          "updatedAt": "2026-08-28T00:00:00Z",
                          "validationIssues": [
                            {
                              "code": "example-value",
                              "message": "example-value",
                              "path": "example-value"
                            }
                          ]
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/WorkflowOverviewResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:195",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List workflows. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnProfilesCommonExecutable",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "post": {
        "description": "### Purpose\nCreate workflows. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiWorkflows",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "definition": {
                      "bpmn": {
                        "categories": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "values": [
                              {
                                "id": "example-value",
                                "value": "example-value"
                              }
                            ]
                          }
                        ],
                        "choreographies": [
                          {
                            "activities": [
                              {
                                "calledElementRef": "example-value",
                                "children": [
                                  {}
                                ],
                                "elementType": "example-value",
                                "id": "example-value",
                                "initiatingParticipantRef": "example-value",
                                "loop": {
                                  "behavior": "example-value",
                                  "collection": "example-value",
                                  "completionCondition": "example-value",
                                  "complexBehaviorDefinitions": [
                                    {
                                      "condition": "example-value",
                                      "eventDefinitions": [
                                        {
                                          "activityRef": "example-value",
                                          "expression": "example-value",
                                          "id": "example-value",
                                          "language": "example-value",
                                          "operationRef": "example-value",
                                          "reference": "example-value",
                                          "sources": [
                                            "example-value"
                                          ],
                                          "target": "example-value",
                                          "timeCycle": "example-value",
                                          "timeDate": "example-value",
                                          "timeDuration": "example-value",
                                          "type": "example-value",
                                          "waitForCompletion": true,
                                          "waitForCompletionSpecified": true
                                        }
                                      ],
                                      "id": "example-value"
                                    }
                                  ],
                                  "elementVariable": "example-value",
                                  "id": "example-value",
                                  "kind": "example-value",
                                  "loopCondition": "example-value",
                                  "loopMaximum": 1,
                                  "noneBehaviorEventRef": "example-value",
                                  "oneBehaviorEventRef": "example-value",
                                  "sequential": true,
                                  "testBefore": true
                                },
                                "messageFlowRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "participantRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "artifacts": [
                              {
                                "associationDirection": "example-value",
                                "categoryValueRef": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "position": {
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "sourceRef": "example-value",
                                "targetRef": "example-value",
                                "text": "example-value"
                              }
                            ],
                            "edges": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "id": "example-value",
                            "initiatingParticipantRef": "example-value",
                            "name": "example-value",
                            "participants": [
                              {
                                "id": "example-value",
                                "multiplicityMaximum": 1,
                                "multiplicityMinimum": 1,
                                "name": "example-value",
                                "partnerEntityRef": "example-value",
                                "partnerRoleRef": "example-value",
                                "processRef": "example-value"
                              }
                            ]
                          }
                        ],
                        "collaborations": [
                          {
                            "artifacts": [
                              {
                                "associationDirection": "example-value",
                                "categoryValueRef": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "position": {
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "sourceRef": "example-value",
                                "targetRef": "example-value",
                                "text": "example-value"
                              }
                            ],
                            "closed": true,
                            "conversationLinks": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "conversations": [
                              {
                                "calledElementRef": "example-value",
                                "children": [
                                  {}
                                ],
                                "elementType": "example-value",
                                "id": "example-value",
                                "messageFlowRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "participantRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "correlationKeys": [
                              {
                                "correlationPropertyRef": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "retrievalExpressions": [
                                  "example-value"
                                ]
                              }
                            ],
                            "id": "example-value",
                            "messageFlows": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "name": "example-value",
                            "participants": [
                              {
                                "id": "example-value",
                                "multiplicityMaximum": 1,
                                "multiplicityMinimum": 1,
                                "name": "example-value",
                                "partnerEntityRef": "example-value",
                                "partnerRoleRef": "example-value",
                                "processRef": "example-value"
                              }
                            ]
                          }
                        ],
                        "conformanceProfile": "example-value",
                        "conversations": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "dataStores": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "diagrams": [
                          {
                            "edges": [
                              {
                                "elementRef": "example-value",
                                "id": "example-value",
                                "label": {
                                  "bounds": {
                                    "height": 1.5,
                                    "width": 1.5,
                                    "x": 1.5,
                                    "y": 1.5
                                  },
                                  "id": "example-value"
                                },
                                "messageVisibleKind": "example-value",
                                "sourceElement": "example-value",
                                "targetElement": "example-value",
                                "waypoints": [
                                  {
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              }
                            ],
                            "elementRef": "example-value",
                            "id": "example-value",
                            "labels": [
                              {
                                "bounds": {
                                  "height": 1.5,
                                  "width": 1.5,
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "id": "example-value"
                              }
                            ],
                            "name": "example-value",
                            "orientation": "example-value",
                            "planeId": "example-value",
                            "shapes": [
                              {
                                "bounds": {
                                  "height": 1.5,
                                  "width": 1.5,
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "choreographyActivityShape": "example-value",
                                "elementRef": "example-value",
                                "expanded": true,
                                "horizontal": true,
                                "id": "example-value",
                                "label": {
                                  "bounds": {
                                    "height": 1.5,
                                    "width": 1.5,
                                    "x": 1.5,
                                    "y": 1.5
                                  },
                                  "id": "example-value"
                                },
                                "markerVisible": true,
                                "participantBandKind": "example-value"
                              }
                            ]
                          }
                        ],
                        "errors": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "escalations": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "exporter": "example-value",
                        "exporterVersion": "example-value",
                        "expressionLanguage": "example-value",
                        "extensionElementsXml": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "imports": [
                          {
                            "importType": "example-value",
                            "location": "example-value",
                            "namespace": "example-value"
                          }
                        ],
                        "interfaces": [
                          {
                            "id": "example-value",
                            "implementationRef": "example-value",
                            "name": "example-value",
                            "operations": [
                              {
                                "errorRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "implementationRef": "example-value",
                                "inputMessageRef": "example-value",
                                "name": "example-value",
                                "outputMessageRef": "example-value"
                              }
                            ]
                          }
                        ],
                        "itemDefinitions": [
                          {
                            "id": "example-value",
                            "isCollection": true,
                            "itemKind": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "messages": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "namespaces": {},
                        "primaryProcessId": "example-value",
                        "processes": [
                          {
                            "artifacts": [
                              {
                                "associationDirection": "example-value",
                                "categoryValueRef": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "position": {
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "sourceRef": "example-value",
                                "targetRef": "example-value",
                                "text": "example-value"
                              }
                            ],
                            "auditingXml": "example-value",
                            "closed": true,
                            "correlations": [
                              {
                                "correlationPropertyRef": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "retrievalExpressions": [
                                  "example-value"
                                ]
                              }
                            ],
                            "dataInputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataObjects": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataOutputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataStores": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "documentation": [
                              "example-value"
                            ],
                            "edges": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "executable": true,
                            "extensionXml": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSets": [
                              {
                                "dataInputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "optionalInputRefs": [
                                  "example-value"
                                ],
                                "outputSetRefs": [
                                  "example-value"
                                ],
                                "whileExecutingInputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "ioSpecificationId": "example-value",
                            "laneSets": [
                              {
                                "id": "example-value",
                                "lanes": [
                                  {
                                    "childLaneSet": {},
                                    "flowNodeRefs": [
                                      "example-value"
                                    ],
                                    "id": "example-value",
                                    "name": "example-value",
                                    "partitionElementRef": "example-value",
                                    "resources": [
                                      {
                                        "assignmentExpression": "example-value",
                                        "id": "example-value",
                                        "resourceRef": "example-value",
                                        "role": "example-value"
                                      }
                                    ]
                                  }
                                ],
                                "name": "example-value"
                              }
                            ],
                            "layout": {
                              "arrangementVersion": 1,
                              "collapsedGroups": {},
                              "nodes": {},
                              "notes": [
                                {
                                  "collapsed": true,
                                  "id": "example-value",
                                  "text": "example-value",
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "monitoringXml": "example-value",
                            "name": "example-value",
                            "nodes": [
                              {
                                "bpmn": {
                                  "activationCondition": "example-value",
                                  "activity": {
                                    "cancelRemainingInstances": true,
                                    "completionCondition": "example-value",
                                    "completionQuantity": 1,
                                    "defaultFlow": "example-value",
                                    "forCompensation": true,
                                    "loop": {
                                      "behavior": "example-value",
                                      "collection": "example-value",
                                      "completionCondition": "example-value",
                                      "complexBehaviorDefinitions": [
                                        {
                                          "condition": "example-value",
                                          "eventDefinitions": [
                                            {
                                              "activityRef": "example-value",
                                              "expression": "example-value",
                                              "id": "example-value",
                                              "language": "example-value",
                                              "operationRef": "example-value",
                                              "reference": "example-value",
                                              "sources": [
                                                "example-value"
                                              ],
                                              "target": "example-value",
                                              "timeCycle": "example-value",
                                              "timeDate": "example-value",
                                              "timeDuration": "example-value",
                                              "type": "example-value",
                                              "waitForCompletion": true,
                                              "waitForCompletionSpecified": true
                                            }
                                          ],
                                          "id": "example-value"
                                        }
                                      ],
                                      "elementVariable": "example-value",
                                      "id": "example-value",
                                      "kind": "example-value",
                                      "loopCondition": "example-value",
                                      "loopMaximum": 1,
                                      "noneBehaviorEventRef": "example-value",
                                      "oneBehaviorEventRef": "example-value",
                                      "sequential": true,
                                      "testBefore": true
                                    },
                                    "method": "example-value",
                                    "ordering": "example-value",
                                    "protocol": "example-value",
                                    "renderings": [
                                      "example-value"
                                    ],
                                    "script": "example-value",
                                    "scriptFormat": "example-value",
                                    "startQuantity": 1
                                  },
                                  "attachedToRef": "example-value",
                                  "calledElement": "example-value",
                                  "cancelActivity": true,
                                  "dataAssociations": [
                                    {
                                      "assignmentExpressions": [
                                        {
                                          "from": "example-value",
                                          "fromLanguage": "example-value",
                                          "id": "example-value",
                                          "to": "example-value",
                                          "toLanguage": "example-value"
                                        }
                                      ],
                                      "assignments": [
                                        "example-value"
                                      ],
                                      "elementType": "example-value",
                                      "id": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "transformation": "example-value"
                                    }
                                  ],
                                  "dataInputs": [
                                    {
                                      "capacity": 1,
                                      "collection": true,
                                      "dataState": "example-value",
                                      "elementType": "example-value",
                                      "id": "example-value",
                                      "itemSubjectRef": "example-value",
                                      "name": "example-value",
                                      "originalRef": "example-value",
                                      "unlimited": true
                                    }
                                  ],
                                  "dataOutputs": [
                                    {
                                      "capacity": 1,
                                      "collection": true,
                                      "dataState": "example-value",
                                      "elementType": "example-value",
                                      "id": "example-value",
                                      "itemSubjectRef": "example-value",
                                      "name": "example-value",
                                      "originalRef": "example-value",
                                      "unlimited": true
                                    }
                                  ],
                                  "defaultFlow": "example-value",
                                  "documentation": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "eventDefinitions": [
                                    {
                                      "activityRef": "example-value",
                                      "expression": "example-value",
                                      "id": "example-value",
                                      "language": "example-value",
                                      "operationRef": "example-value",
                                      "reference": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "timeCycle": "example-value",
                                      "timeDate": "example-value",
                                      "timeDuration": "example-value",
                                      "type": "example-value",
                                      "waitForCompletion": true,
                                      "waitForCompletionSpecified": true
                                    }
                                  ],
                                  "eventGatewayType": "example-value",
                                  "extensionXml": [
                                    "example-value"
                                  ],
                                  "gatewayDirection": "example-value",
                                  "id": "example-value",
                                  "implementation": "example-value",
                                  "inputSets": [
                                    {
                                      "dataInputRefs": [
                                        "example-value"
                                      ],
                                      "id": "example-value",
                                      "name": "example-value",
                                      "optionalInputRefs": [
                                        "example-value"
                                      ],
                                      "outputSetRefs": [
                                        "example-value"
                                      ],
                                      "whileExecutingInputRefs": [
                                        "example-value"
                                      ]
                                    }
                                  ],
                                  "instantiate": true,
                                  "ioSpecificationId": "example-value",
                                  "isInterrupting": true,
                                  "isTransaction": true,
                                  "messageRef": "example-value",
                                  "operationRef": "example-value",
                                  "outputSets": [
                                    {
                                      "dataOutputRefs": [
                                        "example-value"
                                      ],
                                      "id": "example-value",
                                      "inputSetRefs": [
                                        "example-value"
                                      ],
                                      "name": "example-value",
                                      "optionalOutputRefs": [
                                        "example-value"
                                      ],
                                      "whileExecutingOutputRefs": [
                                        "example-value"
                                      ]
                                    }
                                  ],
                                  "parallelMultiple": true,
                                  "properties": [
                                    {
                                      "dataState": "example-value",
                                      "id": "example-value",
                                      "itemSubjectRef": "example-value",
                                      "name": "example-value"
                                    }
                                  ],
                                  "resources": [
                                    {
                                      "assignmentExpression": "example-value",
                                      "id": "example-value",
                                      "resourceRef": "example-value",
                                      "role": "example-value"
                                    }
                                  ],
                                  "subProcess": {},
                                  "transactionMethod": "example-value",
                                  "triggeredByEvent": true
                                },
                                "configuration": {},
                                "displayName": "example-value",
                                "id": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "outputSets": [
                              {
                                "dataOutputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "inputSetRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "optionalOutputRefs": [
                                  "example-value"
                                ],
                                "whileExecutingOutputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "processType": "example-value",
                            "properties": [
                              {
                                "dataState": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value"
                              }
                            ],
                            "resources": [
                              {
                                "assignmentExpression": "example-value",
                                "id": "example-value",
                                "resourceRef": "example-value",
                                "role": "example-value"
                              }
                            ],
                            "supports": [
                              "example-value"
                            ]
                          }
                        ],
                        "relationships": [
                          {
                            "direction": "example-value",
                            "id": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "targets": [
                              "example-value"
                            ],
                            "type": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "parameters": [
                              {
                                "id": "example-value",
                                "name": "example-value",
                                "required": true,
                                "type": "example-value"
                              }
                            ]
                          }
                        ],
                        "signals": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "targetNamespace": "example-value",
                        "typeLanguage": "example-value"
                      },
                      "dmn": {
                        "elements": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "id": "example-value",
                            "name": "example-value",
                            "nodeId": "example-value",
                            "type": "example-value",
                            "typeRef": "example-value",
                            "variableName": "example-value"
                          }
                        ],
                        "fileName": "example-value",
                        "importedDocuments": [
                          {
                            "fileName": "example-value",
                            "namespace": "example-value",
                            "sourceSha256": "example-value",
                            "sourceXml": "example-value"
                          }
                        ],
                        "namespace": "example-value",
                        "requirements": [
                          {
                            "id": "example-value",
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "type": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          }
                        ],
                        "sourceSha256": "example-value",
                        "sourceXml": "example-value",
                        "version": "example-value"
                      },
                      "edges": [
                        {
                          "bpmn": {
                            "assignments": [
                              "example-value"
                            ],
                            "associationDirection": "example-value",
                            "conditionExpression": "example-value",
                            "conditionLanguage": "example-value",
                            "correlationKeyRefs": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "isImmediate": true,
                            "messageRef": "example-value",
                            "name": "example-value",
                            "operationRef": "example-value",
                            "transformation": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          },
                          "branch": "example-value",
                          "condition": {
                            "label": "example-value",
                            "left": "example-value",
                            "on": "example-value",
                            "operator": "example-value",
                            "value": "example-value"
                          },
                          "id": "example-value",
                          "loop": {
                            "carry": {
                              "previousError": true,
                              "previousOutput": true,
                              "reviewerFeedback": true,
                              "validationFeedback": true,
                              "variables": [
                                "example-value"
                              ]
                            },
                            "delaySeconds": 1,
                            "maximumIterations": 1,
                            "onMaximum": {
                              "action": "example-value",
                              "target": "example-value"
                            }
                          },
                          "source": "example-value",
                          "target": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "imports": [
                        {
                          "executable": true,
                          "format": "example-value",
                          "items": [
                            {
                              "configuration": {},
                              "elementId": "example-value",
                              "elementType": "example-value",
                              "message": "example-value",
                              "name": "example-value",
                              "outcome": "example-value",
                              "sourceId": "example-value",
                              "sourceKind": "example-value"
                            }
                          ],
                          "sourceFileName": "example-value",
                          "sourceSha256": "example-value",
                          "version": "example-value"
                        }
                      ],
                      "layout": {
                        "arrangementVersion": 1,
                        "collapsedGroups": {},
                        "nodes": {},
                        "notes": [
                          {
                            "collapsed": true,
                            "id": "example-value",
                            "text": "example-value",
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      },
                      "nodes": [
                        {
                          "bpmn": {
                            "activationCondition": "example-value",
                            "activity": {
                              "cancelRemainingInstances": true,
                              "completionCondition": "example-value",
                              "completionQuantity": 1,
                              "defaultFlow": "example-value",
                              "forCompensation": true,
                              "loop": {
                                "behavior": "example-value",
                                "collection": "example-value",
                                "completionCondition": "example-value",
                                "complexBehaviorDefinitions": [
                                  {
                                    "condition": "example-value",
                                    "eventDefinitions": [
                                      {
                                        "activityRef": "example-value",
                                        "expression": "example-value",
                                        "id": "example-value",
                                        "language": "example-value",
                                        "operationRef": "example-value",
                                        "reference": "example-value",
                                        "sources": [
                                          "example-value"
                                        ],
                                        "target": "example-value",
                                        "timeCycle": "example-value",
                                        "timeDate": "example-value",
                                        "timeDuration": "example-value",
                                        "type": "example-value",
                                        "waitForCompletion": true,
                                        "waitForCompletionSpecified": true
                                      }
                                    ],
                                    "id": "example-value"
                                  }
                                ],
                                "elementVariable": "example-value",
                                "id": "example-value",
                                "kind": "example-value",
                                "loopCondition": "example-value",
                                "loopMaximum": 1,
                                "noneBehaviorEventRef": "example-value",
                                "oneBehaviorEventRef": "example-value",
                                "sequential": true,
                                "testBefore": true
                              },
                              "method": "example-value",
                              "ordering": "example-value",
                              "protocol": "example-value",
                              "renderings": [
                                "example-value"
                              ],
                              "script": "example-value",
                              "scriptFormat": "example-value",
                              "startQuantity": 1
                            },
                            "attachedToRef": "example-value",
                            "calledElement": "example-value",
                            "cancelActivity": true,
                            "dataAssociations": [
                              {
                                "assignmentExpressions": [
                                  {
                                    "from": "example-value",
                                    "fromLanguage": "example-value",
                                    "id": "example-value",
                                    "to": "example-value",
                                    "toLanguage": "example-value"
                                  }
                                ],
                                "assignments": [
                                  "example-value"
                                ],
                                "elementType": "example-value",
                                "id": "example-value",
                                "sources": [
                                  "example-value"
                                ],
                                "target": "example-value",
                                "transformation": "example-value"
                              }
                            ],
                            "dataInputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataOutputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "defaultFlow": "example-value",
                            "documentation": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "eventDefinitions": [
                              {
                                "activityRef": "example-value",
                                "expression": "example-value",
                                "id": "example-value",
                                "language": "example-value",
                                "operationRef": "example-value",
                                "reference": "example-value",
                                "sources": [
                                  "example-value"
                                ],
                                "target": "example-value",
                                "timeCycle": "example-value",
                                "timeDate": "example-value",
                                "timeDuration": "example-value",
                                "type": "example-value",
                                "waitForCompletion": true,
                                "waitForCompletionSpecified": true
                              }
                            ],
                            "eventGatewayType": "example-value",
                            "extensionXml": [
                              "example-value"
                            ],
                            "gatewayDirection": "example-value",
                            "id": "example-value",
                            "implementation": "example-value",
                            "inputSets": [
                              {
                                "dataInputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "optionalInputRefs": [
                                  "example-value"
                                ],
                                "outputSetRefs": [
                                  "example-value"
                                ],
                                "whileExecutingInputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "instantiate": true,
                            "ioSpecificationId": "example-value",
                            "isInterrupting": true,
                            "isTransaction": true,
                            "messageRef": "example-value",
                            "operationRef": "example-value",
                            "outputSets": [
                              {
                                "dataOutputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "inputSetRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "optionalOutputRefs": [
                                  "example-value"
                                ],
                                "whileExecutingOutputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "parallelMultiple": true,
                            "properties": [
                              {
                                "dataState": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value"
                              }
                            ],
                            "resources": [
                              {
                                "assignmentExpression": "example-value",
                                "id": "example-value",
                                "resourceRef": "example-value",
                                "role": "example-value"
                              }
                            ],
                            "subProcess": {
                              "artifacts": [
                                {
                                  "associationDirection": "example-value",
                                  "categoryValueRef": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "name": "example-value",
                                  "position": {
                                    "x": 1.5,
                                    "y": 1.5
                                  },
                                  "sourceRef": "example-value",
                                  "targetRef": "example-value",
                                  "text": "example-value"
                                }
                              ],
                              "auditingXml": "example-value",
                              "closed": true,
                              "correlations": [
                                {
                                  "correlationPropertyRef": "example-value",
                                  "id": "example-value",
                                  "name": "example-value",
                                  "retrievalExpressions": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "dataInputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataObjects": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataOutputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataStores": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "documentation": [
                                "example-value"
                              ],
                              "edges": [
                                {
                                  "bpmn": {
                                    "assignments": [
                                      "example-value"
                                    ],
                                    "associationDirection": "example-value",
                                    "conditionExpression": "example-value",
                                    "conditionLanguage": "example-value",
                                    "correlationKeyRefs": [
                                      "example-value"
                                    ],
                                    "elementType": "example-value",
                                    "isImmediate": true,
                                    "messageRef": "example-value",
                                    "name": "example-value",
                                    "operationRef": "example-value",
                                    "transformation": "example-value",
                                    "waypoints": [
                                      {
                                        "x": 1.5,
                                        "y": 1.5
                                      }
                                    ]
                                  },
                                  "branch": "example-value",
                                  "condition": {
                                    "label": "example-value",
                                    "left": "example-value",
                                    "on": "example-value",
                                    "operator": "example-value",
                                    "value": "example-value"
                                  },
                                  "id": "example-value",
                                  "loop": {
                                    "carry": {
                                      "previousError": true,
                                      "previousOutput": true,
                                      "reviewerFeedback": true,
                                      "validationFeedback": true,
                                      "variables": [
                                        "example-value"
                                      ]
                                    },
                                    "delaySeconds": 1,
                                    "maximumIterations": 1,
                                    "onMaximum": {
                                      "action": "example-value",
                                      "target": "example-value"
                                    }
                                  },
                                  "source": "example-value",
                                  "target": "example-value",
                                  "type": "example-value"
                                }
                              ],
                              "executable": true,
                              "extensionXml": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "inputSets": [
                                {
                                  "dataInputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "optionalInputRefs": [
                                    "example-value"
                                  ],
                                  "outputSetRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingInputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "ioSpecificationId": "example-value",
                              "laneSets": [
                                {
                                  "id": "example-value",
                                  "lanes": [
                                    {
                                      "childLaneSet": {},
                                      "flowNodeRefs": [
                                        "example-value"
                                      ],
                                      "id": "example-value",
                                      "name": "example-value",
                                      "partitionElementRef": "example-value",
                                      "resources": [
                                        {
                                          "assignmentExpression": "example-value",
                                          "id": "example-value",
                                          "resourceRef": "example-value",
                                          "role": "example-value"
                                        }
                                      ]
                                    }
                                  ],
                                  "name": "example-value"
                                }
                              ],
                              "layout": {
                                "arrangementVersion": 1,
                                "collapsedGroups": {},
                                "nodes": {},
                                "notes": [
                                  {
                                    "collapsed": true,
                                    "id": "example-value",
                                    "text": "example-value",
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              },
                              "monitoringXml": "example-value",
                              "name": "example-value",
                              "nodes": [
                                {}
                              ],
                              "outputSets": [
                                {
                                  "dataOutputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "inputSetRefs": [
                                    "example-value"
                                  ],
                                  "name": "example-value",
                                  "optionalOutputRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingOutputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "processType": "example-value",
                              "properties": [
                                {
                                  "dataState": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value"
                                }
                              ],
                              "resources": [
                                {
                                  "assignmentExpression": "example-value",
                                  "id": "example-value",
                                  "resourceRef": "example-value",
                                  "role": "example-value"
                                }
                              ],
                              "supports": [
                                "example-value"
                              ]
                            },
                            "transactionMethod": "example-value",
                            "triggeredByEvent": true
                          },
                          "configuration": {},
                          "displayName": "example-value",
                          "id": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "protection": {
                        "customChecks": [
                          "example-value"
                        ],
                        "preset": "example-value"
                      },
                      "schemaVersion": 1
                    },
                    "description": "example-value",
                    "displayName": "example-value",
                    "folderId": "example-value",
                    "slug": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "description": "example-value",
                    "displayName": "example-value",
                    "slug": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/WorkflowCreateInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The resource was created and the response contains its current representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:209",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "workflow.created"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "definition": {
                  "bpmn": {
                    "categories": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "values": [
                          {
                            "id": "example-value",
                            "value": "example-value"
                          }
                        ]
                      }
                    ],
                    "choreographies": [
                      {
                        "activities": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "initiatingParticipantRef": "example-value",
                            "loop": {
                              "behavior": "example-value",
                              "collection": "example-value",
                              "completionCondition": "example-value",
                              "complexBehaviorDefinitions": [
                                {
                                  "condition": "example-value",
                                  "eventDefinitions": [
                                    {
                                      "activityRef": "example-value",
                                      "expression": "example-value",
                                      "id": "example-value",
                                      "language": "example-value",
                                      "operationRef": "example-value",
                                      "reference": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "timeCycle": "example-value",
                                      "timeDate": "example-value",
                                      "timeDuration": "example-value",
                                      "type": "example-value",
                                      "waitForCompletion": true,
                                      "waitForCompletionSpecified": true
                                    }
                                  ],
                                  "id": "example-value"
                                }
                              ],
                              "elementVariable": "example-value",
                              "id": "example-value",
                              "kind": "example-value",
                              "loopCondition": "example-value",
                              "loopMaximum": 1,
                              "noneBehaviorEventRef": "example-value",
                              "oneBehaviorEventRef": "example-value",
                              "sequential": true,
                              "testBefore": true
                            },
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "id": "example-value",
                        "initiatingParticipantRef": "example-value",
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "collaborations": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "closed": true,
                        "conversationLinks": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "conversations": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "correlationKeys": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "id": "example-value",
                        "messageFlows": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "conformanceProfile": "example-value",
                    "conversations": [
                      {
                        "calledElementRef": "example-value",
                        "children": [
                          {}
                        ],
                        "elementType": "example-value",
                        "id": "example-value",
                        "messageFlowRefs": [
                          "example-value"
                        ],
                        "name": "example-value",
                        "participantRefs": [
                          "example-value"
                        ]
                      }
                    ],
                    "dataStores": [
                      {
                        "capacity": 1,
                        "collection": true,
                        "dataState": "example-value",
                        "elementType": "example-value",
                        "id": "example-value",
                        "itemSubjectRef": "example-value",
                        "name": "example-value",
                        "originalRef": "example-value",
                        "unlimited": true
                      }
                    ],
                    "diagrams": [
                      {
                        "edges": [
                          {
                            "elementRef": "example-value",
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "messageVisibleKind": "example-value",
                            "sourceElement": "example-value",
                            "targetElement": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          }
                        ],
                        "elementRef": "example-value",
                        "id": "example-value",
                        "labels": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "id": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "orientation": "example-value",
                        "planeId": "example-value",
                        "shapes": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "choreographyActivityShape": "example-value",
                            "elementRef": "example-value",
                            "expanded": true,
                            "horizontal": true,
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "markerVisible": true,
                            "participantBandKind": "example-value"
                          }
                        ]
                      }
                    ],
                    "errors": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "escalations": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "exporter": "example-value",
                    "exporterVersion": "example-value",
                    "expressionLanguage": "example-value",
                    "extensionElementsXml": [
                      "example-value"
                    ],
                    "id": "example-value",
                    "imports": [
                      {
                        "importType": "example-value",
                        "location": "example-value",
                        "namespace": "example-value"
                      }
                    ],
                    "interfaces": [
                      {
                        "id": "example-value",
                        "implementationRef": "example-value",
                        "name": "example-value",
                        "operations": [
                          {
                            "errorRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "implementationRef": "example-value",
                            "inputMessageRef": "example-value",
                            "name": "example-value",
                            "outputMessageRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "itemDefinitions": [
                      {
                        "id": "example-value",
                        "isCollection": true,
                        "itemKind": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "messages": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "name": "example-value",
                    "namespaces": {},
                    "primaryProcessId": "example-value",
                    "processes": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "auditingXml": "example-value",
                        "closed": true,
                        "correlations": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataObjects": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataStores": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "documentation": [
                          "example-value"
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "executable": true,
                        "extensionXml": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "ioSpecificationId": "example-value",
                        "laneSets": [
                          {
                            "id": "example-value",
                            "lanes": [
                              {
                                "childLaneSet": {},
                                "flowNodeRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "partitionElementRef": "example-value",
                                "resources": [
                                  {
                                    "assignmentExpression": "example-value",
                                    "id": "example-value",
                                    "resourceRef": "example-value",
                                    "role": "example-value"
                                  }
                                ]
                              }
                            ],
                            "name": "example-value"
                          }
                        ],
                        "layout": {
                          "arrangementVersion": 1,
                          "collapsedGroups": {},
                          "nodes": {},
                          "notes": [
                            {
                              "collapsed": true,
                              "id": "example-value",
                              "text": "example-value",
                              "x": 1.5,
                              "y": 1.5
                            }
                          ]
                        },
                        "monitoringXml": "example-value",
                        "name": "example-value",
                        "nodes": [
                          {
                            "bpmn": {
                              "activationCondition": "example-value",
                              "activity": {
                                "cancelRemainingInstances": true,
                                "completionCondition": "example-value",
                                "completionQuantity": 1,
                                "defaultFlow": "example-value",
                                "forCompensation": true,
                                "loop": {
                                  "behavior": "example-value",
                                  "collection": "example-value",
                                  "completionCondition": "example-value",
                                  "complexBehaviorDefinitions": [
                                    {
                                      "condition": "example-value",
                                      "eventDefinitions": [
                                        {
                                          "activityRef": "example-value",
                                          "expression": "example-value",
                                          "id": "example-value",
                                          "language": "example-value",
                                          "operationRef": "example-value",
                                          "reference": "example-value",
                                          "sources": [
                                            "example-value"
                                          ],
                                          "target": "example-value",
                                          "timeCycle": "example-value",
                                          "timeDate": "example-value",
                                          "timeDuration": "example-value",
                                          "type": "example-value",
                                          "waitForCompletion": true,
                                          "waitForCompletionSpecified": true
                                        }
                                      ],
                                      "id": "example-value"
                                    }
                                  ],
                                  "elementVariable": "example-value",
                                  "id": "example-value",
                                  "kind": "example-value",
                                  "loopCondition": "example-value",
                                  "loopMaximum": 1,
                                  "noneBehaviorEventRef": "example-value",
                                  "oneBehaviorEventRef": "example-value",
                                  "sequential": true,
                                  "testBefore": true
                                },
                                "method": "example-value",
                                "ordering": "example-value",
                                "protocol": "example-value",
                                "renderings": [
                                  "example-value"
                                ],
                                "script": "example-value",
                                "scriptFormat": "example-value",
                                "startQuantity": 1
                              },
                              "attachedToRef": "example-value",
                              "calledElement": "example-value",
                              "cancelActivity": true,
                              "dataAssociations": [
                                {
                                  "assignmentExpressions": [
                                    {
                                      "from": "example-value",
                                      "fromLanguage": "example-value",
                                      "id": "example-value",
                                      "to": "example-value",
                                      "toLanguage": "example-value"
                                    }
                                  ],
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "transformation": "example-value"
                                }
                              ],
                              "dataInputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataOutputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "defaultFlow": "example-value",
                              "documentation": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "eventDefinitions": [
                                {
                                  "activityRef": "example-value",
                                  "expression": "example-value",
                                  "id": "example-value",
                                  "language": "example-value",
                                  "operationRef": "example-value",
                                  "reference": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "timeCycle": "example-value",
                                  "timeDate": "example-value",
                                  "timeDuration": "example-value",
                                  "type": "example-value",
                                  "waitForCompletion": true,
                                  "waitForCompletionSpecified": true
                                }
                              ],
                              "eventGatewayType": "example-value",
                              "extensionXml": [
                                "example-value"
                              ],
                              "gatewayDirection": "example-value",
                              "id": "example-value",
                              "implementation": "example-value",
                              "inputSets": [
                                {
                                  "dataInputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "optionalInputRefs": [
                                    "example-value"
                                  ],
                                  "outputSetRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingInputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "instantiate": true,
                              "ioSpecificationId": "example-value",
                              "isInterrupting": true,
                              "isTransaction": true,
                              "messageRef": "example-value",
                              "operationRef": "example-value",
                              "outputSets": [
                                {
                                  "dataOutputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "inputSetRefs": [
                                    "example-value"
                                  ],
                                  "name": "example-value",
                                  "optionalOutputRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingOutputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "parallelMultiple": true,
                              "properties": [
                                {
                                  "dataState": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value"
                                }
                              ],
                              "resources": [
                                {
                                  "assignmentExpression": "example-value",
                                  "id": "example-value",
                                  "resourceRef": "example-value",
                                  "role": "example-value"
                                }
                              ],
                              "subProcess": {},
                              "transactionMethod": "example-value",
                              "triggeredByEvent": true
                            },
                            "configuration": {},
                            "displayName": "example-value",
                            "id": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "processType": "example-value",
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "supports": [
                          "example-value"
                        ]
                      }
                    ],
                    "relationships": [
                      {
                        "direction": "example-value",
                        "id": "example-value",
                        "sources": [
                          "example-value"
                        ],
                        "targets": [
                          "example-value"
                        ],
                        "type": "example-value"
                      }
                    ],
                    "resources": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "parameters": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "required": true,
                            "type": "example-value"
                          }
                        ]
                      }
                    ],
                    "signals": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "targetNamespace": "example-value",
                    "typeLanguage": "example-value"
                  },
                  "dmn": {
                    "elements": [
                      {
                        "bounds": {
                          "height": 1.5,
                          "width": 1.5,
                          "x": 1.5,
                          "y": 1.5
                        },
                        "id": "example-value",
                        "name": "example-value",
                        "nodeId": "example-value",
                        "type": "example-value",
                        "typeRef": "example-value",
                        "variableName": "example-value"
                      }
                    ],
                    "fileName": "example-value",
                    "importedDocuments": [
                      {
                        "fileName": "example-value",
                        "namespace": "example-value",
                        "sourceSha256": "example-value",
                        "sourceXml": "example-value"
                      }
                    ],
                    "namespace": "example-value",
                    "requirements": [
                      {
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "targetRef": "example-value",
                        "type": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      }
                    ],
                    "sourceSha256": "example-value",
                    "sourceXml": "example-value",
                    "version": "example-value"
                  },
                  "edges": [
                    {
                      "bpmn": {
                        "assignments": [
                          "example-value"
                        ],
                        "associationDirection": "example-value",
                        "conditionExpression": "example-value",
                        "conditionLanguage": "example-value",
                        "correlationKeyRefs": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "isImmediate": true,
                        "messageRef": "example-value",
                        "name": "example-value",
                        "operationRef": "example-value",
                        "transformation": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      },
                      "branch": "example-value",
                      "condition": {
                        "label": "example-value",
                        "left": "example-value",
                        "on": "example-value",
                        "operator": "example-value",
                        "value": "example-value"
                      },
                      "id": "example-value",
                      "loop": {
                        "carry": {
                          "previousError": true,
                          "previousOutput": true,
                          "reviewerFeedback": true,
                          "validationFeedback": true,
                          "variables": [
                            "example-value"
                          ]
                        },
                        "delaySeconds": 1,
                        "maximumIterations": 1,
                        "onMaximum": {
                          "action": "example-value",
                          "target": "example-value"
                        }
                      },
                      "source": "example-value",
                      "target": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "imports": [
                    {
                      "executable": true,
                      "format": "example-value",
                      "items": [
                        {
                          "configuration": {},
                          "elementId": "example-value",
                          "elementType": "example-value",
                          "message": "example-value",
                          "name": "example-value",
                          "outcome": "example-value",
                          "sourceId": "example-value",
                          "sourceKind": "example-value"
                        }
                      ],
                      "sourceFileName": "example-value",
                      "sourceSha256": "example-value",
                      "version": "example-value"
                    }
                  ],
                  "layout": {
                    "arrangementVersion": 1,
                    "collapsedGroups": {},
                    "nodes": {},
                    "notes": [
                      {
                        "collapsed": true,
                        "id": "example-value",
                        "text": "example-value",
                        "x": 1.5,
                        "y": 1.5
                      }
                    ]
                  },
                  "nodes": [
                    {
                      "bpmn": {
                        "activationCondition": "example-value",
                        "activity": {
                          "cancelRemainingInstances": true,
                          "completionCondition": "example-value",
                          "completionQuantity": 1,
                          "defaultFlow": "example-value",
                          "forCompensation": true,
                          "loop": {
                            "behavior": "example-value",
                            "collection": "example-value",
                            "completionCondition": "example-value",
                            "complexBehaviorDefinitions": [
                              {
                                "condition": "example-value",
                                "eventDefinitions": [
                                  {
                                    "activityRef": "example-value",
                                    "expression": "example-value",
                                    "id": "example-value",
                                    "language": "example-value",
                                    "operationRef": "example-value",
                                    "reference": "example-value",
                                    "sources": [
                                      "example-value"
                                    ],
                                    "target": "example-value",
                                    "timeCycle": "example-value",
                                    "timeDate": "example-value",
                                    "timeDuration": "example-value",
                                    "type": "example-value",
                                    "waitForCompletion": true,
                                    "waitForCompletionSpecified": true
                                  }
                                ],
                                "id": "example-value"
                              }
                            ],
                            "elementVariable": "example-value",
                            "id": "example-value",
                            "kind": "example-value",
                            "loopCondition": "example-value",
                            "loopMaximum": 1,
                            "noneBehaviorEventRef": "example-value",
                            "oneBehaviorEventRef": "example-value",
                            "sequential": true,
                            "testBefore": true
                          },
                          "method": "example-value",
                          "ordering": "example-value",
                          "protocol": "example-value",
                          "renderings": [
                            "example-value"
                          ],
                          "script": "example-value",
                          "scriptFormat": "example-value",
                          "startQuantity": 1
                        },
                        "attachedToRef": "example-value",
                        "calledElement": "example-value",
                        "cancelActivity": true,
                        "dataAssociations": [
                          {
                            "assignmentExpressions": [
                              {
                                "from": "example-value",
                                "fromLanguage": "example-value",
                                "id": "example-value",
                                "to": "example-value",
                                "toLanguage": "example-value"
                              }
                            ],
                            "assignments": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "defaultFlow": "example-value",
                        "documentation": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "eventDefinitions": [
                          {
                            "activityRef": "example-value",
                            "expression": "example-value",
                            "id": "example-value",
                            "language": "example-value",
                            "operationRef": "example-value",
                            "reference": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "timeCycle": "example-value",
                            "timeDate": "example-value",
                            "timeDuration": "example-value",
                            "type": "example-value",
                            "waitForCompletion": true,
                            "waitForCompletionSpecified": true
                          }
                        ],
                        "eventGatewayType": "example-value",
                        "extensionXml": [
                          "example-value"
                        ],
                        "gatewayDirection": "example-value",
                        "id": "example-value",
                        "implementation": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "instantiate": true,
                        "ioSpecificationId": "example-value",
                        "isInterrupting": true,
                        "isTransaction": true,
                        "messageRef": "example-value",
                        "operationRef": "example-value",
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "parallelMultiple": true,
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "subProcess": {
                          "artifacts": [
                            {
                              "associationDirection": "example-value",
                              "categoryValueRef": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "position": {
                                "x": 1.5,
                                "y": 1.5
                              },
                              "sourceRef": "example-value",
                              "targetRef": "example-value",
                              "text": "example-value"
                            }
                          ],
                          "auditingXml": "example-value",
                          "closed": true,
                          "correlations": [
                            {
                              "correlationPropertyRef": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "retrievalExpressions": [
                                "example-value"
                              ]
                            }
                          ],
                          "dataInputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataObjects": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataOutputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataStores": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "documentation": [
                            "example-value"
                          ],
                          "edges": [
                            {
                              "bpmn": {
                                "assignments": [
                                  "example-value"
                                ],
                                "associationDirection": "example-value",
                                "conditionExpression": "example-value",
                                "conditionLanguage": "example-value",
                                "correlationKeyRefs": [
                                  "example-value"
                                ],
                                "elementType": "example-value",
                                "isImmediate": true,
                                "messageRef": "example-value",
                                "name": "example-value",
                                "operationRef": "example-value",
                                "transformation": "example-value",
                                "waypoints": [
                                  {
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              },
                              "branch": "example-value",
                              "condition": {
                                "label": "example-value",
                                "left": "example-value",
                                "on": "example-value",
                                "operator": "example-value",
                                "value": "example-value"
                              },
                              "id": "example-value",
                              "loop": {
                                "carry": {
                                  "previousError": true,
                                  "previousOutput": true,
                                  "reviewerFeedback": true,
                                  "validationFeedback": true,
                                  "variables": [
                                    "example-value"
                                  ]
                                },
                                "delaySeconds": 1,
                                "maximumIterations": 1,
                                "onMaximum": {
                                  "action": "example-value",
                                  "target": "example-value"
                                }
                              },
                              "source": "example-value",
                              "target": "example-value",
                              "type": "example-value"
                            }
                          ],
                          "executable": true,
                          "extensionXml": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "inputSets": [
                            {
                              "dataInputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "name": "example-value",
                              "optionalInputRefs": [
                                "example-value"
                              ],
                              "outputSetRefs": [
                                "example-value"
                              ],
                              "whileExecutingInputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "ioSpecificationId": "example-value",
                          "laneSets": [
                            {
                              "id": "example-value",
                              "lanes": [
                                {
                                  "childLaneSet": {},
                                  "flowNodeRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "partitionElementRef": "example-value",
                                  "resources": [
                                    {
                                      "assignmentExpression": "example-value",
                                      "id": "example-value",
                                      "resourceRef": "example-value",
                                      "role": "example-value"
                                    }
                                  ]
                                }
                              ],
                              "name": "example-value"
                            }
                          ],
                          "layout": {
                            "arrangementVersion": 1,
                            "collapsedGroups": {},
                            "nodes": {},
                            "notes": [
                              {
                                "collapsed": true,
                                "id": "example-value",
                                "text": "example-value",
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          },
                          "monitoringXml": "example-value",
                          "name": "example-value",
                          "nodes": [
                            {}
                          ],
                          "outputSets": [
                            {
                              "dataOutputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "inputSetRefs": [
                                "example-value"
                              ],
                              "name": "example-value",
                              "optionalOutputRefs": [
                                "example-value"
                              ],
                              "whileExecutingOutputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "processType": "example-value",
                          "properties": [
                            {
                              "dataState": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value"
                            }
                          ],
                          "resources": [
                            {
                              "assignmentExpression": "example-value",
                              "id": "example-value",
                              "resourceRef": "example-value",
                              "role": "example-value"
                            }
                          ],
                          "supports": [
                            "example-value"
                          ]
                        },
                        "transactionMethod": "example-value",
                        "triggeredByEvent": true
                      },
                      "configuration": {},
                      "displayName": "example-value",
                      "id": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "protection": {
                    "customChecks": [
                      "example-value"
                    ],
                    "preset": "example-value"
                  },
                  "schemaVersion": 1
                },
                "description": "example-value",
                "displayName": "example-value",
                "folderId": "example-value",
                "slug": "example-value"
              },
              "method": "POST",
              "path": "/api/workflows"
            },
            "response": {
              "status": "201"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "definition": {
                  "bpmn": {
                    "categories": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "values": [
                          {
                            "id": "example-value",
                            "value": "example-value"
                          }
                        ]
                      }
                    ],
                    "choreographies": [
                      {
                        "activities": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "initiatingParticipantRef": "example-value",
                            "loop": {
                              "behavior": "example-value",
                              "collection": "example-value",
                              "completionCondition": "example-value",
                              "complexBehaviorDefinitions": [
                                {
                                  "condition": "example-value",
                                  "eventDefinitions": [
                                    {
                                      "activityRef": "example-value",
                                      "expression": "example-value",
                                      "id": "example-value",
                                      "language": "example-value",
                                      "operationRef": "example-value",
                                      "reference": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "timeCycle": "example-value",
                                      "timeDate": "example-value",
                                      "timeDuration": "example-value",
                                      "type": "example-value",
                                      "waitForCompletion": true,
                                      "waitForCompletionSpecified": true
                                    }
                                  ],
                                  "id": "example-value"
                                }
                              ],
                              "elementVariable": "example-value",
                              "id": "example-value",
                              "kind": "example-value",
                              "loopCondition": "example-value",
                              "loopMaximum": 1,
                              "noneBehaviorEventRef": "example-value",
                              "oneBehaviorEventRef": "example-value",
                              "sequential": true,
                              "testBefore": true
                            },
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "id": "example-value",
                        "initiatingParticipantRef": "example-value",
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "collaborations": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "closed": true,
                        "conversationLinks": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "conversations": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "correlationKeys": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "id": "example-value",
                        "messageFlows": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "conformanceProfile": "example-value",
                    "conversations": [
                      {
                        "calledElementRef": "example-value",
                        "children": [
                          {}
                        ],
                        "elementType": "example-value",
                        "id": "example-value",
                        "messageFlowRefs": [
                          "example-value"
                        ],
                        "name": "example-value",
                        "participantRefs": [
                          "example-value"
                        ]
                      }
                    ],
                    "dataStores": [
                      {
                        "capacity": 1,
                        "collection": true,
                        "dataState": "example-value",
                        "elementType": "example-value",
                        "id": "example-value",
                        "itemSubjectRef": "example-value",
                        "name": "example-value",
                        "originalRef": "example-value",
                        "unlimited": true
                      }
                    ],
                    "diagrams": [
                      {
                        "edges": [
                          {
                            "elementRef": "example-value",
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "messageVisibleKind": "example-value",
                            "sourceElement": "example-value",
                            "targetElement": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          }
                        ],
                        "elementRef": "example-value",
                        "id": "example-value",
                        "labels": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "id": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "orientation": "example-value",
                        "planeId": "example-value",
                        "shapes": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "choreographyActivityShape": "example-value",
                            "elementRef": "example-value",
                            "expanded": true,
                            "horizontal": true,
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "markerVisible": true,
                            "participantBandKind": "example-value"
                          }
                        ]
                      }
                    ],
                    "errors": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "escalations": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "exporter": "example-value",
                    "exporterVersion": "example-value",
                    "expressionLanguage": "example-value",
                    "extensionElementsXml": [
                      "example-value"
                    ],
                    "id": "example-value",
                    "imports": [
                      {
                        "importType": "example-value",
                        "location": "example-value",
                        "namespace": "example-value"
                      }
                    ],
                    "interfaces": [
                      {
                        "id": "example-value",
                        "implementationRef": "example-value",
                        "name": "example-value",
                        "operations": [
                          {
                            "errorRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "implementationRef": "example-value",
                            "inputMessageRef": "example-value",
                            "name": "example-value",
                            "outputMessageRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "itemDefinitions": [
                      {
                        "id": "example-value",
                        "isCollection": true,
                        "itemKind": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "messages": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "name": "example-value",
                    "namespaces": {},
                    "primaryProcessId": "example-value",
                    "processes": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "auditingXml": "example-value",
                        "closed": true,
                        "correlations": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataObjects": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataStores": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "documentation": [
                          "example-value"
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "executable": true,
                        "extensionXml": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "ioSpecificationId": "example-value",
                        "laneSets": [
                          {
                            "id": "example-value",
                            "lanes": [
                              {
                                "childLaneSet": {},
                                "flowNodeRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "partitionElementRef": "example-value",
                                "resources": [
                                  {
                                    "assignmentExpression": "example-value",
                                    "id": "example-value",
                                    "resourceRef": "example-value",
                                    "role": "example-value"
                                  }
                                ]
                              }
                            ],
                            "name": "example-value"
                          }
                        ],
                        "layout": {
                          "arrangementVersion": 1,
                          "collapsedGroups": {},
                          "nodes": {},
                          "notes": [
                            {
                              "collapsed": true,
                              "id": "example-value",
                              "text": "example-value",
                              "x": 1.5,
                              "y": 1.5
                            }
                          ]
                        },
                        "monitoringXml": "example-value",
                        "name": "example-value",
                        "nodes": [
                          {
                            "bpmn": {
                              "activationCondition": "example-value",
                              "activity": {
                                "cancelRemainingInstances": true,
                                "completionCondition": "example-value",
                                "completionQuantity": 1,
                                "defaultFlow": "example-value",
                                "forCompensation": true,
                                "loop": {
                                  "behavior": "example-value",
                                  "collection": "example-value",
                                  "completionCondition": "example-value",
                                  "complexBehaviorDefinitions": [
                                    {
                                      "condition": "example-value",
                                      "eventDefinitions": [
                                        {
                                          "activityRef": "example-value",
                                          "expression": "example-value",
                                          "id": "example-value",
                                          "language": "example-value",
                                          "operationRef": "example-value",
                                          "reference": "example-value",
                                          "sources": [
                                            "example-value"
                                          ],
                                          "target": "example-value",
                                          "timeCycle": "example-value",
                                          "timeDate": "example-value",
                                          "timeDuration": "example-value",
                                          "type": "example-value",
                                          "waitForCompletion": true,
                                          "waitForCompletionSpecified": true
                                        }
                                      ],
                                      "id": "example-value"
                                    }
                                  ],
                                  "elementVariable": "example-value",
                                  "id": "example-value",
                                  "kind": "example-value",
                                  "loopCondition": "example-value",
                                  "loopMaximum": 1,
                                  "noneBehaviorEventRef": "example-value",
                                  "oneBehaviorEventRef": "example-value",
                                  "sequential": true,
                                  "testBefore": true
                                },
                                "method": "example-value",
                                "ordering": "example-value",
                                "protocol": "example-value",
                                "renderings": [
                                  "example-value"
                                ],
                                "script": "example-value",
                                "scriptFormat": "example-value",
                                "startQuantity": 1
                              },
                              "attachedToRef": "example-value",
                              "calledElement": "example-value",
                              "cancelActivity": true,
                              "dataAssociations": [
                                {
                                  "assignmentExpressions": [
                                    {
                                      "from": "example-value",
                                      "fromLanguage": "example-value",
                                      "id": "example-value",
                                      "to": "example-value",
                                      "toLanguage": "example-value"
                                    }
                                  ],
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "transformation": "example-value"
                                }
                              ],
                              "dataInputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataOutputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "defaultFlow": "example-value",
                              "documentation": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "eventDefinitions": [
                                {
                                  "activityRef": "example-value",
                                  "expression": "example-value",
                                  "id": "example-value",
                                  "language": "example-value",
                                  "operationRef": "example-value",
                                  "reference": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "timeCycle": "example-value",
                                  "timeDate": "example-value",
                                  "timeDuration": "example-value",
                                  "type": "example-value",
                                  "waitForCompletion": true,
                                  "waitForCompletionSpecified": true
                                }
                              ],
                              "eventGatewayType": "example-value",
                              "extensionXml": [
                                "example-value"
                              ],
                              "gatewayDirection": "example-value",
                              "id": "example-value",
                              "implementation": "example-value",
                              "inputSets": [
                                {
                                  "dataInputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "optionalInputRefs": [
                                    "example-value"
                                  ],
                                  "outputSetRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingInputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "instantiate": true,
                              "ioSpecificationId": "example-value",
                              "isInterrupting": true,
                              "isTransaction": true,
                              "messageRef": "example-value",
                              "operationRef": "example-value",
                              "outputSets": [
                                {
                                  "dataOutputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "inputSetRefs": [
                                    "example-value"
                                  ],
                                  "name": "example-value",
                                  "optionalOutputRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingOutputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "parallelMultiple": true,
                              "properties": [
                                {
                                  "dataState": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value"
                                }
                              ],
                              "resources": [
                                {
                                  "assignmentExpression": "example-value",
                                  "id": "example-value",
                                  "resourceRef": "example-value",
                                  "role": "example-value"
                                }
                              ],
                              "subProcess": {},
                              "transactionMethod": "example-value",
                              "triggeredByEvent": true
                            },
                            "configuration": {},
                            "displayName": "example-value",
                            "id": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "processType": "example-value",
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "supports": [
                          "example-value"
                        ]
                      }
                    ],
                    "relationships": [
                      {
                        "direction": "example-value",
                        "id": "example-value",
                        "sources": [
                          "example-value"
                        ],
                        "targets": [
                          "example-value"
                        ],
                        "type": "example-value"
                      }
                    ],
                    "resources": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "parameters": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "required": true,
                            "type": "example-value"
                          }
                        ]
                      }
                    ],
                    "signals": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "targetNamespace": "example-value",
                    "typeLanguage": "example-value"
                  },
                  "dmn": {
                    "elements": [
                      {
                        "bounds": {
                          "height": 1.5,
                          "width": 1.5,
                          "x": 1.5,
                          "y": 1.5
                        },
                        "id": "example-value",
                        "name": "example-value",
                        "nodeId": "example-value",
                        "type": "example-value",
                        "typeRef": "example-value",
                        "variableName": "example-value"
                      }
                    ],
                    "fileName": "example-value",
                    "importedDocuments": [
                      {
                        "fileName": "example-value",
                        "namespace": "example-value",
                        "sourceSha256": "example-value",
                        "sourceXml": "example-value"
                      }
                    ],
                    "namespace": "example-value",
                    "requirements": [
                      {
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "targetRef": "example-value",
                        "type": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      }
                    ],
                    "sourceSha256": "example-value",
                    "sourceXml": "example-value",
                    "version": "example-value"
                  },
                  "edges": [
                    {
                      "bpmn": {
                        "assignments": [
                          "example-value"
                        ],
                        "associationDirection": "example-value",
                        "conditionExpression": "example-value",
                        "conditionLanguage": "example-value",
                        "correlationKeyRefs": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "isImmediate": true,
                        "messageRef": "example-value",
                        "name": "example-value",
                        "operationRef": "example-value",
                        "transformation": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      },
                      "branch": "example-value",
                      "condition": {
                        "label": "example-value",
                        "left": "example-value",
                        "on": "example-value",
                        "operator": "example-value",
                        "value": "example-value"
                      },
                      "id": "example-value",
                      "loop": {
                        "carry": {
                          "previousError": true,
                          "previousOutput": true,
                          "reviewerFeedback": true,
                          "validationFeedback": true,
                          "variables": [
                            "example-value"
                          ]
                        },
                        "delaySeconds": 1,
                        "maximumIterations": 1,
                        "onMaximum": {
                          "action": "example-value",
                          "target": "example-value"
                        }
                      },
                      "source": "example-value",
                      "target": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "imports": [
                    {
                      "executable": true,
                      "format": "example-value",
                      "items": [
                        {
                          "configuration": {},
                          "elementId": "example-value",
                          "elementType": "example-value",
                          "message": "example-value",
                          "name": "example-value",
                          "outcome": "example-value",
                          "sourceId": "example-value",
                          "sourceKind": "example-value"
                        }
                      ],
                      "sourceFileName": "example-value",
                      "sourceSha256": "example-value",
                      "version": "example-value"
                    }
                  ],
                  "layout": {
                    "arrangementVersion": 1,
                    "collapsedGroups": {},
                    "nodes": {},
                    "notes": [
                      {
                        "collapsed": true,
                        "id": "example-value",
                        "text": "example-value",
                        "x": 1.5,
                        "y": 1.5
                      }
                    ]
                  },
                  "nodes": [
                    {
                      "bpmn": {
                        "activationCondition": "example-value",
                        "activity": {
                          "cancelRemainingInstances": true,
                          "completionCondition": "example-value",
                          "completionQuantity": 1,
                          "defaultFlow": "example-value",
                          "forCompensation": true,
                          "loop": {
                            "behavior": "example-value",
                            "collection": "example-value",
                            "completionCondition": "example-value",
                            "complexBehaviorDefinitions": [
                              {
                                "condition": "example-value",
                                "eventDefinitions": [
                                  {
                                    "activityRef": "example-value",
                                    "expression": "example-value",
                                    "id": "example-value",
                                    "language": "example-value",
                                    "operationRef": "example-value",
                                    "reference": "example-value",
                                    "sources": [
                                      "example-value"
                                    ],
                                    "target": "example-value",
                                    "timeCycle": "example-value",
                                    "timeDate": "example-value",
                                    "timeDuration": "example-value",
                                    "type": "example-value",
                                    "waitForCompletion": true,
                                    "waitForCompletionSpecified": true
                                  }
                                ],
                                "id": "example-value"
                              }
                            ],
                            "elementVariable": "example-value",
                            "id": "example-value",
                            "kind": "example-value",
                            "loopCondition": "example-value",
                            "loopMaximum": 1,
                            "noneBehaviorEventRef": "example-value",
                            "oneBehaviorEventRef": "example-value",
                            "sequential": true,
                            "testBefore": true
                          },
                          "method": "example-value",
                          "ordering": "example-value",
                          "protocol": "example-value",
                          "renderings": [
                            "example-value"
                          ],
                          "script": "example-value",
                          "scriptFormat": "example-value",
                          "startQuantity": 1
                        },
                        "attachedToRef": "example-value",
                        "calledElement": "example-value",
                        "cancelActivity": true,
                        "dataAssociations": [
                          {
                            "assignmentExpressions": [
                              {
                                "from": "example-value",
                                "fromLanguage": "example-value",
                                "id": "example-value",
                                "to": "example-value",
                                "toLanguage": "example-value"
                              }
                            ],
                            "assignments": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "defaultFlow": "example-value",
                        "documentation": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "eventDefinitions": [
                          {
                            "activityRef": "example-value",
                            "expression": "example-value",
                            "id": "example-value",
                            "language": "example-value",
                            "operationRef": "example-value",
                            "reference": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "timeCycle": "example-value",
                            "timeDate": "example-value",
                            "timeDuration": "example-value",
                            "type": "example-value",
                            "waitForCompletion": true,
                            "waitForCompletionSpecified": true
                          }
                        ],
                        "eventGatewayType": "example-value",
                        "extensionXml": [
                          "example-value"
                        ],
                        "gatewayDirection": "example-value",
                        "id": "example-value",
                        "implementation": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "instantiate": true,
                        "ioSpecificationId": "example-value",
                        "isInterrupting": true,
                        "isTransaction": true,
                        "messageRef": "example-value",
                        "operationRef": "example-value",
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "parallelMultiple": true,
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "subProcess": {
                          "artifacts": [
                            {
                              "associationDirection": "example-value",
                              "categoryValueRef": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "position": {
                                "x": 1.5,
                                "y": 1.5
                              },
                              "sourceRef": "example-value",
                              "targetRef": "example-value",
                              "text": "example-value"
                            }
                          ],
                          "auditingXml": "example-value",
                          "closed": true,
                          "correlations": [
                            {
                              "correlationPropertyRef": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "retrievalExpressions": [
                                "example-value"
                              ]
                            }
                          ],
                          "dataInputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataObjects": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataOutputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataStores": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "documentation": [
                            "example-value"
                          ],
                          "edges": [
                            {
                              "bpmn": {
                                "assignments": [
                                  "example-value"
                                ],
                                "associationDirection": "example-value",
                                "conditionExpression": "example-value",
                                "conditionLanguage": "example-value",
                                "correlationKeyRefs": [
                                  "example-value"
                                ],
                                "elementType": "example-value",
                                "isImmediate": true,
                                "messageRef": "example-value",
                                "name": "example-value",
                                "operationRef": "example-value",
                                "transformation": "example-value",
                                "waypoints": [
                                  {
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              },
                              "branch": "example-value",
                              "condition": {
                                "label": "example-value",
                                "left": "example-value",
                                "on": "example-value",
                                "operator": "example-value",
                                "value": "example-value"
                              },
                              "id": "example-value",
                              "loop": {
                                "carry": {
                                  "previousError": true,
                                  "previousOutput": true,
                                  "reviewerFeedback": true,
                                  "validationFeedback": true,
                                  "variables": [
                                    "example-value"
                                  ]
                                },
                                "delaySeconds": 1,
                                "maximumIterations": 1,
                                "onMaximum": {
                                  "action": "example-value",
                                  "target": "example-value"
                                }
                              },
                              "source": "example-value",
                              "target": "example-value",
                              "type": "example-value"
                            }
                          ],
                          "executable": true,
                          "extensionXml": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "inputSets": [
                            {
                              "dataInputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "name": "example-value",
                              "optionalInputRefs": [
                                "example-value"
                              ],
                              "outputSetRefs": [
                                "example-value"
                              ],
                              "whileExecutingInputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "ioSpecificationId": "example-value",
                          "laneSets": [
                            {
                              "id": "example-value",
                              "lanes": [
                                {
                                  "childLaneSet": {},
                                  "flowNodeRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "partitionElementRef": "example-value",
                                  "resources": [
                                    {
                                      "assignmentExpression": "example-value",
                                      "id": "example-value",
                                      "resourceRef": "example-value",
                                      "role": "example-value"
                                    }
                                  ]
                                }
                              ],
                              "name": "example-value"
                            }
                          ],
                          "layout": {
                            "arrangementVersion": 1,
                            "collapsedGroups": {},
                            "nodes": {},
                            "notes": [
                              {
                                "collapsed": true,
                                "id": "example-value",
                                "text": "example-value",
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          },
                          "monitoringXml": "example-value",
                          "name": "example-value",
                          "nodes": [
                            {}
                          ],
                          "outputSets": [
                            {
                              "dataOutputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "inputSetRefs": [
                                "example-value"
                              ],
                              "name": "example-value",
                              "optionalOutputRefs": [
                                "example-value"
                              ],
                              "whileExecutingOutputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "processType": "example-value",
                          "properties": [
                            {
                              "dataState": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value"
                            }
                          ],
                          "resources": [
                            {
                              "assignmentExpression": "example-value",
                              "id": "example-value",
                              "resourceRef": "example-value",
                              "role": "example-value"
                            }
                          ],
                          "supports": [
                            "example-value"
                          ]
                        },
                        "transactionMethod": "example-value",
                        "triggeredByEvent": true
                      },
                      "configuration": {},
                      "displayName": "example-value",
                      "id": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "protection": {
                    "customChecks": [
                      "example-value"
                    ],
                    "preset": "example-value"
                  },
                  "schemaVersion": 1
                },
                "description": "example-value",
                "displayName": "example-value",
                "folderId": "example-value",
                "slug": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/workflows"
            },
            "response": {
              "status": "201"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/workflows"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Create workflows. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/workflows/bpmn/conformance": {
      "get": {
        "description": "### Purpose\nList workflows conformance. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsBpmnConformance",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "class": "example-value",
                          "description": "example-value",
                          "evidence": "example-value",
                          "id": "example-value",
                          "status": "example-value"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/WorkflowBPMNConformanceFeatureResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List workflows conformance",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:26",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/bpmn/conformance"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/bpmn/conformance"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/bpmn/conformance"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List workflows conformance. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnProfilesCommonExecutable",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/bpmn/conformance/report": {
      "get": {
        "description": "### Purpose\nList workflows report. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsBpmnConformanceReport",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "claims",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "example-value",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "claimGates": [
                          {
                            "blockers": [
                              "example-value"
                            ],
                            "complete": true,
                            "description": "example-value",
                            "id": "example-value",
                            "normativeReference": "example-value",
                            "requiredEvidence": [
                              "example-value"
                            ],
                            "status": "example-value"
                          }
                        ],
                        "claims": [
                          {
                            "class": "example-value",
                            "description": "example-value",
                            "evidence": "example-value",
                            "id": "example-value",
                            "status": "example-value"
                          }
                        ],
                        "normativeTests": [
                          {
                            "behavior": "example-value",
                            "claim": "example-value",
                            "evidence": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "limitation": "example-value",
                            "normativeReference": "example-value",
                            "requirementId": "example-value",
                            "status": "example-value",
                            "testModes": [
                              "example-value"
                            ]
                          }
                        ],
                        "releaseEvidence": {
                          "externalToolInteroperability": true,
                          "fullMiwgCorpus": true,
                          "independentReview": true
                        },
                        "releaseGate": {
                          "blockers": [
                            "example-value"
                          ],
                          "complete": true
                        },
                        "requirements": [
                          {
                            "capability": "example-value",
                            "class": "example-value",
                            "evidence": "example-value",
                            "id": "example-value",
                            "limitation": "example-value",
                            "normativeReference": "example-value",
                            "status": "example-value",
                            "testObligations": [
                              "example-value"
                            ]
                          }
                        ],
                        "schemaSource": "example-value",
                        "selectedClaims": [
                          "example-value"
                        ],
                        "standard": "example-value",
                        "summary": {
                          "implemented": 1,
                          "partial": 1,
                          "planned": 1
                        },
                        "version": "example-value"
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WorkflowBPMNConformanceReportResponse",
                      "description": "The operation-specific result.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List workflows report",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:33",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/bpmn/conformance/report"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/bpmn/conformance/report"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/bpmn/conformance/report"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List workflows report. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnProfilesCommonExecutable",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/bpmn/profiles/common-executable": {
      "get": {
        "description": "### Purpose\nList workflows common executable. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsBpmnProfilesCommonExecutable",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "dataAccessLanguage": "example-value",
                        "dataTypeLanguage": "example-value",
                        "description": "example-value",
                        "elements": [
                          {
                            "attributes": [
                              "example-value"
                            ],
                            "element": "example-value",
                            "evidence": [
                              "example-value"
                            ],
                            "normativeReference": "example-value",
                            "notes": [
                              "example-value"
                            ],
                            "optionalAttributes": [
                              "example-value"
                            ],
                            "status": "example-value",
                            "testObligations": [
                              "example-value"
                            ],
                            "variant": "example-value"
                          }
                        ],
                        "id": "example-value",
                        "serviceInterfaceLanguage": "example-value",
                        "standard": "example-value",
                        "version": "example-value"
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WorkflowBPMNProfileDefinitionResponse",
                      "description": "The operation-specific result.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List workflows common executable",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:61",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/bpmn/profiles/common-executable"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/bpmn/profiles/common-executable"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/bpmn/profiles/common-executable"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List workflows common executable. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/dmn/conformance": {
      "get": {
        "description": "### Purpose\nList workflows conformance. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsDmnConformance",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "capability": "example-value",
                          "evidence": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "limitation": "example-value",
                          "normativeReference": "example-value",
                          "status": "example-value"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/WorkflowDMNConformanceRequirementResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List workflows conformance",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:46",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/dmn/conformance"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/dmn/conformance"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/dmn/conformance"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List workflows conformance. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/dmn/conformance/report": {
      "get": {
        "description": "### Purpose\nList workflows report. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsDmnConformanceReport",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "level",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "example-value",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "levels": [
                          {
                            "blockers": [
                              "example-value"
                            ],
                            "complete": true,
                            "level": 1,
                            "name": "example-value",
                            "normativeScope": [
                              "example-value"
                            ],
                            "requiredEvidence": [
                              "example-value"
                            ]
                          }
                        ],
                        "normativeSource": "example-value",
                        "releaseEvidence": {
                          "externalInteroperability": true,
                          "fullTck": true,
                          "independentReview": true
                        },
                        "releaseGate": {
                          "blockers": [
                            "example-value"
                          ],
                          "complete": true
                        },
                        "requestedLevel": 1,
                        "requirements": [
                          {
                            "capability": "example-value",
                            "evidence": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "limitation": "example-value",
                            "normativeReference": "example-value",
                            "status": "example-value"
                          }
                        ],
                        "schemaSource": "example-value",
                        "standard": "example-value",
                        "summary": {
                          "implemented": 1,
                          "partial": 1,
                          "planned": 1
                        },
                        "version": "example-value"
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WorkflowDMNConformanceReportResponse",
                      "description": "The operation-specific result.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List workflows report",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:53",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/dmn/conformance/report"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/dmn/conformance/report"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/dmn/conformance/report"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List workflows report. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/protection/catalog": {
      "get": {
        "description": "### Purpose\nList workflows catalog. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsProtectionCatalog",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {}
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": true,
                      "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                      "example": {},
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "List workflows catalog",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:302",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/protection/catalog"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/protection/catalog"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/protection/catalog"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "List workflows catalog. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/transform/preview": {
      "post": {
        "description": "### Purpose\nPreview workflows. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiWorkflowsTransformPreview",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "configuration": {},
                    "input": "example-value",
                    "variables": {}
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "configuration": {},
                    "input": "example-value",
                    "variables": {}
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "configuration": {
                    "additionalProperties": true,
                    "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                    "example": {},
                    "type": "object",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-arbitrary": true,
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "input": {
                    "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                    "example": "example-value",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-arbitrary": true,
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "variables": {
                    "additionalProperties": true,
                    "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                    "example": {},
                    "type": "object",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-arbitrary": true,
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "configuration",
                  "input",
                  "variables"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "output": "example-value"
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "output": {
                          "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                          "example": "example-value",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-arbitrary": true,
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "output"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Preview workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "create",
          "resourceScope": "",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:228",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "configuration": {},
                "input": "example-value",
                "variables": {}
              },
              "method": "POST",
              "path": "/api/workflows/transform/preview"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "configuration": {},
                "input": "example-value",
                "variables": {}
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/workflows/transform/preview"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/workflows/transform/preview"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Preview workflows. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/workflows/{workflowId}": {
      "delete": {
        "description": "### Purpose\nDelete workflows. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiWorkflowsWorkflowId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:335",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete workflows. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnProfilesCommonExecutable",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "get": {
        "description": "### Purpose\nGet workflows. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:303",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "patch": {
        "description": "### Purpose\nUpdate workflows. This applies only the supplied changes.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "patchapiWorkflowsWorkflowId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "description": "Assesses a fictitious complaint and routes it for approval.",
                    "displayName": "Complaint assessment",
                    "folderId": "example-folder-id",
                    "status": "draft"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {}
                }
              },
              "schema": {
                "additionalProperties": false,
                "description": "A partial update. Supply at least one documented property; omitted properties remain unchanged.",
                "minProperties": 1,
                "properties": {
                  "description": {
                    "description": "Workflow purpose and scope shown to users.",
                    "example": "Assesses a fictitious complaint and routes it for approval.",
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "An empty string clears the description; null is not a documented value.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable while the workflow exists.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  },
                  "displayName": {
                    "description": "Human-readable workflow name shown to users.",
                    "example": "Complaint assessment",
                    "minLength": 1,
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "An empty or whitespace-only value is ignored; omit the field to retain the current name.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable while the workflow exists.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  },
                  "folderId": {
                    "description": "Folder identifier that should contain the workflow.",
                    "example": "example-folder-id",
                    "type": [
                      "string",
                      "null"
                    ],
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "Omission retains the current folder. Null or an empty string moves the workflow to the root; any other non-string value is rejected.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Updateable when the destination folder is valid and does not create an invalid hierarchy.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  },
                  "status": {
                    "description": "Requested workflow lifecycle state.",
                    "enum": [
                      "draft",
                      "published",
                      "retired"
                    ],
                    "example": "draft",
                    "type": "string",
                    "x-punaha-access": "Changing this field requires the operation's exact update action.",
                    "x-punaha-availability": "Inherits the operation availability.",
                    "x-punaha-default": "Omission retains the current value; no client default is applied.",
                    "x-punaha-empty": "Omit the field to retain the current state; empty and null values are ignored and should not be sent.",
                    "x-punaha-handling": "Treat tenant-authored text according to the tenant data-classification and retention policy.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "State-dependent; use purpose-built publish or validation actions when documented.",
                    "x-punaha-presence": "optional",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and stored after validation."
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:317",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "description": "Assesses a fictitious complaint and routes it for approval.",
                "displayName": "Complaint assessment",
                "folderId": "example-folder-id",
                "status": "draft"
              },
              "method": "PATCH",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "description": "Assesses a fictitious complaint and routes it for approval.",
                "displayName": "Complaint assessment",
                "folderId": "example-folder-id",
                "status": "draft"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PATCH",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PATCH",
              "path": "/api/workflows/example-workflowId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Update workflows. This applies only the supplied changes.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/workflows/{workflowId}/dmn/logic": {
      "get": {
        "description": "### Purpose\nGet workflows dmn. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdDmnLogic",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "elementId",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "example-elementid",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "elementKind",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "example-value",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows dmn",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:380",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/dmn/logic"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/dmn/logic"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/dmn/logic"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows dmn. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "put": {
        "description": "### Purpose\nDmn workflows. This replaces or sets the selected state using the full supplied value.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "putapiWorkflowsWorkflowIdDmnLogic",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "edit": "example-value",
                    "elementId": "example-value",
                    "elementKind": "example-value",
                    "kind": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "edit": "example-value",
                    "elementId": "example-value",
                    "elementKind": "example-value",
                    "kind": "example-value"
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/WorkflowDMNLogicEditRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "logic": {
                          "edit": "example-value",
                          "elementId": "example-value",
                          "elementKind": "example-value",
                          "kind": "example-value",
                          "simple": true,
                          "visual": {
                            "aggregation": "example-value",
                            "children": [
                              {
                                "expression": {},
                                "name": "example-value",
                                "role": "example-value",
                                "typeRef": "example-value"
                              }
                            ],
                            "columns": [
                              "example-value"
                            ],
                            "hitPolicy": "example-value",
                            "inputs": [
                              {
                                "expression": "example-value",
                                "label": "example-value",
                                "typeRef": "example-value"
                              }
                            ],
                            "kind": "example-value",
                            "name": "example-value",
                            "outputs": [
                              {
                                "label": "example-value",
                                "name": "example-value",
                                "typeRef": "example-value"
                              }
                            ],
                            "params": [
                              {
                                "name": "example-value",
                                "typeRef": "example-value"
                              }
                            ],
                            "rows": [
                              [
                                {}
                              ]
                            ],
                            "rules": [
                              {
                                "annotations": [
                                  "example-value"
                                ],
                                "inputEntries": [
                                  "example-value"
                                ],
                                "outputEntries": [
                                  "example-value"
                                ]
                              }
                            ],
                            "text": "example-value",
                            "typeRef": "example-value",
                            "variable": "example-value"
                          }
                        },
                        "workflow": {
                          "access": {},
                          "createdAt": "2026-08-28T00:00:00Z",
                          "definition": "example-value",
                          "description": "example-value",
                          "displayName": "example-value",
                          "folderId": "example-value",
                          "id": "example-value",
                          "organizationId": "example-value",
                          "publishedVersion": 1,
                          "slug": "example-value",
                          "status": "example-value",
                          "updatedAt": "2026-08-28T00:00:00Z"
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "The operation-specific result.",
                      "example": {},
                      "properties": {
                        "logic": {
                          "$ref": "#/components/schemas/WorkflowDMNLogicViewResponse",
                          "description": "The logic associated with this resource or operation.",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "workflow": {
                          "$ref": "#/components/schemas/DatabaseWorkflowRecordResponse",
                          "description": "The workflow associated with this resource or operation.",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "logic",
                        "workflow"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Dmn workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:393",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "edit": "example-value",
                "elementId": "example-value",
                "elementKind": "example-value",
                "kind": "example-value"
              },
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/dmn/logic"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "edit": "example-value",
                "elementId": "example-value",
                "elementKind": "example-value",
                "kind": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/dmn/logic"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/dmn/logic"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Dmn workflows. This replaces or sets the selected state using the full supplied value.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/workflows/{workflowId}/draft": {
      "put": {
        "description": "### Purpose\nDraft workflows. This replaces or sets the selected state using the full supplied value.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "putapiWorkflowsWorkflowIdDraft",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "definition": {
                      "bpmn": {
                        "categories": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "values": [
                              {
                                "id": "example-value",
                                "value": "example-value"
                              }
                            ]
                          }
                        ],
                        "choreographies": [
                          {
                            "activities": [
                              {
                                "calledElementRef": "example-value",
                                "children": [
                                  {}
                                ],
                                "elementType": "example-value",
                                "id": "example-value",
                                "initiatingParticipantRef": "example-value",
                                "loop": {
                                  "behavior": "example-value",
                                  "collection": "example-value",
                                  "completionCondition": "example-value",
                                  "complexBehaviorDefinitions": [
                                    {
                                      "condition": "example-value",
                                      "eventDefinitions": [
                                        {
                                          "activityRef": "example-value",
                                          "expression": "example-value",
                                          "id": "example-value",
                                          "language": "example-value",
                                          "operationRef": "example-value",
                                          "reference": "example-value",
                                          "sources": [
                                            "example-value"
                                          ],
                                          "target": "example-value",
                                          "timeCycle": "example-value",
                                          "timeDate": "example-value",
                                          "timeDuration": "example-value",
                                          "type": "example-value",
                                          "waitForCompletion": true,
                                          "waitForCompletionSpecified": true
                                        }
                                      ],
                                      "id": "example-value"
                                    }
                                  ],
                                  "elementVariable": "example-value",
                                  "id": "example-value",
                                  "kind": "example-value",
                                  "loopCondition": "example-value",
                                  "loopMaximum": 1,
                                  "noneBehaviorEventRef": "example-value",
                                  "oneBehaviorEventRef": "example-value",
                                  "sequential": true,
                                  "testBefore": true
                                },
                                "messageFlowRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "participantRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "artifacts": [
                              {
                                "associationDirection": "example-value",
                                "categoryValueRef": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "position": {
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "sourceRef": "example-value",
                                "targetRef": "example-value",
                                "text": "example-value"
                              }
                            ],
                            "edges": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "id": "example-value",
                            "initiatingParticipantRef": "example-value",
                            "name": "example-value",
                            "participants": [
                              {
                                "id": "example-value",
                                "multiplicityMaximum": 1,
                                "multiplicityMinimum": 1,
                                "name": "example-value",
                                "partnerEntityRef": "example-value",
                                "partnerRoleRef": "example-value",
                                "processRef": "example-value"
                              }
                            ]
                          }
                        ],
                        "collaborations": [
                          {
                            "artifacts": [
                              {
                                "associationDirection": "example-value",
                                "categoryValueRef": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "position": {
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "sourceRef": "example-value",
                                "targetRef": "example-value",
                                "text": "example-value"
                              }
                            ],
                            "closed": true,
                            "conversationLinks": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "conversations": [
                              {
                                "calledElementRef": "example-value",
                                "children": [
                                  {}
                                ],
                                "elementType": "example-value",
                                "id": "example-value",
                                "messageFlowRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "participantRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "correlationKeys": [
                              {
                                "correlationPropertyRef": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "retrievalExpressions": [
                                  "example-value"
                                ]
                              }
                            ],
                            "id": "example-value",
                            "messageFlows": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "name": "example-value",
                            "participants": [
                              {
                                "id": "example-value",
                                "multiplicityMaximum": 1,
                                "multiplicityMinimum": 1,
                                "name": "example-value",
                                "partnerEntityRef": "example-value",
                                "partnerRoleRef": "example-value",
                                "processRef": "example-value"
                              }
                            ]
                          }
                        ],
                        "conformanceProfile": "example-value",
                        "conversations": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "dataStores": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "diagrams": [
                          {
                            "edges": [
                              {
                                "elementRef": "example-value",
                                "id": "example-value",
                                "label": {
                                  "bounds": {
                                    "height": 1.5,
                                    "width": 1.5,
                                    "x": 1.5,
                                    "y": 1.5
                                  },
                                  "id": "example-value"
                                },
                                "messageVisibleKind": "example-value",
                                "sourceElement": "example-value",
                                "targetElement": "example-value",
                                "waypoints": [
                                  {
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              }
                            ],
                            "elementRef": "example-value",
                            "id": "example-value",
                            "labels": [
                              {
                                "bounds": {
                                  "height": 1.5,
                                  "width": 1.5,
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "id": "example-value"
                              }
                            ],
                            "name": "example-value",
                            "orientation": "example-value",
                            "planeId": "example-value",
                            "shapes": [
                              {
                                "bounds": {
                                  "height": 1.5,
                                  "width": 1.5,
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "choreographyActivityShape": "example-value",
                                "elementRef": "example-value",
                                "expanded": true,
                                "horizontal": true,
                                "id": "example-value",
                                "label": {
                                  "bounds": {
                                    "height": 1.5,
                                    "width": 1.5,
                                    "x": 1.5,
                                    "y": 1.5
                                  },
                                  "id": "example-value"
                                },
                                "markerVisible": true,
                                "participantBandKind": "example-value"
                              }
                            ]
                          }
                        ],
                        "errors": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "escalations": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "exporter": "example-value",
                        "exporterVersion": "example-value",
                        "expressionLanguage": "example-value",
                        "extensionElementsXml": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "imports": [
                          {
                            "importType": "example-value",
                            "location": "example-value",
                            "namespace": "example-value"
                          }
                        ],
                        "interfaces": [
                          {
                            "id": "example-value",
                            "implementationRef": "example-value",
                            "name": "example-value",
                            "operations": [
                              {
                                "errorRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "implementationRef": "example-value",
                                "inputMessageRef": "example-value",
                                "name": "example-value",
                                "outputMessageRef": "example-value"
                              }
                            ]
                          }
                        ],
                        "itemDefinitions": [
                          {
                            "id": "example-value",
                            "isCollection": true,
                            "itemKind": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "messages": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "namespaces": {},
                        "primaryProcessId": "example-value",
                        "processes": [
                          {
                            "artifacts": [
                              {
                                "associationDirection": "example-value",
                                "categoryValueRef": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "position": {
                                  "x": 1.5,
                                  "y": 1.5
                                },
                                "sourceRef": "example-value",
                                "targetRef": "example-value",
                                "text": "example-value"
                              }
                            ],
                            "auditingXml": "example-value",
                            "closed": true,
                            "correlations": [
                              {
                                "correlationPropertyRef": "example-value",
                                "id": "example-value",
                                "name": "example-value",
                                "retrievalExpressions": [
                                  "example-value"
                                ]
                              }
                            ],
                            "dataInputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataObjects": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataOutputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataStores": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "documentation": [
                              "example-value"
                            ],
                            "edges": [
                              {
                                "bpmn": {
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "associationDirection": "example-value",
                                  "conditionExpression": "example-value",
                                  "conditionLanguage": "example-value",
                                  "correlationKeyRefs": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "isImmediate": true,
                                  "messageRef": "example-value",
                                  "name": "example-value",
                                  "operationRef": "example-value",
                                  "transformation": "example-value",
                                  "waypoints": [
                                    {
                                      "x": 1.5,
                                      "y": 1.5
                                    }
                                  ]
                                },
                                "branch": "example-value",
                                "condition": {
                                  "label": "example-value",
                                  "left": "example-value",
                                  "on": "example-value",
                                  "operator": "example-value",
                                  "value": "example-value"
                                },
                                "id": "example-value",
                                "loop": {
                                  "carry": {
                                    "previousError": true,
                                    "previousOutput": true,
                                    "reviewerFeedback": true,
                                    "validationFeedback": true,
                                    "variables": [
                                      "example-value"
                                    ]
                                  },
                                  "delaySeconds": 1,
                                  "maximumIterations": 1,
                                  "onMaximum": {
                                    "action": "example-value",
                                    "target": "example-value"
                                  }
                                },
                                "source": "example-value",
                                "target": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "executable": true,
                            "extensionXml": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSets": [
                              {
                                "dataInputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "optionalInputRefs": [
                                  "example-value"
                                ],
                                "outputSetRefs": [
                                  "example-value"
                                ],
                                "whileExecutingInputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "ioSpecificationId": "example-value",
                            "laneSets": [
                              {
                                "id": "example-value",
                                "lanes": [
                                  {
                                    "childLaneSet": {},
                                    "flowNodeRefs": [
                                      "example-value"
                                    ],
                                    "id": "example-value",
                                    "name": "example-value",
                                    "partitionElementRef": "example-value",
                                    "resources": [
                                      {
                                        "assignmentExpression": "example-value",
                                        "id": "example-value",
                                        "resourceRef": "example-value",
                                        "role": "example-value"
                                      }
                                    ]
                                  }
                                ],
                                "name": "example-value"
                              }
                            ],
                            "layout": {
                              "arrangementVersion": 1,
                              "collapsedGroups": {},
                              "nodes": {},
                              "notes": [
                                {
                                  "collapsed": true,
                                  "id": "example-value",
                                  "text": "example-value",
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "monitoringXml": "example-value",
                            "name": "example-value",
                            "nodes": [
                              {
                                "bpmn": {
                                  "activationCondition": "example-value",
                                  "activity": {
                                    "cancelRemainingInstances": true,
                                    "completionCondition": "example-value",
                                    "completionQuantity": 1,
                                    "defaultFlow": "example-value",
                                    "forCompensation": true,
                                    "loop": {
                                      "behavior": "example-value",
                                      "collection": "example-value",
                                      "completionCondition": "example-value",
                                      "complexBehaviorDefinitions": [
                                        {
                                          "condition": "example-value",
                                          "eventDefinitions": [
                                            {
                                              "activityRef": "example-value",
                                              "expression": "example-value",
                                              "id": "example-value",
                                              "language": "example-value",
                                              "operationRef": "example-value",
                                              "reference": "example-value",
                                              "sources": [
                                                "example-value"
                                              ],
                                              "target": "example-value",
                                              "timeCycle": "example-value",
                                              "timeDate": "example-value",
                                              "timeDuration": "example-value",
                                              "type": "example-value",
                                              "waitForCompletion": true,
                                              "waitForCompletionSpecified": true
                                            }
                                          ],
                                          "id": "example-value"
                                        }
                                      ],
                                      "elementVariable": "example-value",
                                      "id": "example-value",
                                      "kind": "example-value",
                                      "loopCondition": "example-value",
                                      "loopMaximum": 1,
                                      "noneBehaviorEventRef": "example-value",
                                      "oneBehaviorEventRef": "example-value",
                                      "sequential": true,
                                      "testBefore": true
                                    },
                                    "method": "example-value",
                                    "ordering": "example-value",
                                    "protocol": "example-value",
                                    "renderings": [
                                      "example-value"
                                    ],
                                    "script": "example-value",
                                    "scriptFormat": "example-value",
                                    "startQuantity": 1
                                  },
                                  "attachedToRef": "example-value",
                                  "calledElement": "example-value",
                                  "cancelActivity": true,
                                  "dataAssociations": [
                                    {
                                      "assignmentExpressions": [
                                        {
                                          "from": "example-value",
                                          "fromLanguage": "example-value",
                                          "id": "example-value",
                                          "to": "example-value",
                                          "toLanguage": "example-value"
                                        }
                                      ],
                                      "assignments": [
                                        "example-value"
                                      ],
                                      "elementType": "example-value",
                                      "id": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "transformation": "example-value"
                                    }
                                  ],
                                  "dataInputs": [
                                    {
                                      "capacity": 1,
                                      "collection": true,
                                      "dataState": "example-value",
                                      "elementType": "example-value",
                                      "id": "example-value",
                                      "itemSubjectRef": "example-value",
                                      "name": "example-value",
                                      "originalRef": "example-value",
                                      "unlimited": true
                                    }
                                  ],
                                  "dataOutputs": [
                                    {
                                      "capacity": 1,
                                      "collection": true,
                                      "dataState": "example-value",
                                      "elementType": "example-value",
                                      "id": "example-value",
                                      "itemSubjectRef": "example-value",
                                      "name": "example-value",
                                      "originalRef": "example-value",
                                      "unlimited": true
                                    }
                                  ],
                                  "defaultFlow": "example-value",
                                  "documentation": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "eventDefinitions": [
                                    {
                                      "activityRef": "example-value",
                                      "expression": "example-value",
                                      "id": "example-value",
                                      "language": "example-value",
                                      "operationRef": "example-value",
                                      "reference": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "timeCycle": "example-value",
                                      "timeDate": "example-value",
                                      "timeDuration": "example-value",
                                      "type": "example-value",
                                      "waitForCompletion": true,
                                      "waitForCompletionSpecified": true
                                    }
                                  ],
                                  "eventGatewayType": "example-value",
                                  "extensionXml": [
                                    "example-value"
                                  ],
                                  "gatewayDirection": "example-value",
                                  "id": "example-value",
                                  "implementation": "example-value",
                                  "inputSets": [
                                    {
                                      "dataInputRefs": [
                                        "example-value"
                                      ],
                                      "id": "example-value",
                                      "name": "example-value",
                                      "optionalInputRefs": [
                                        "example-value"
                                      ],
                                      "outputSetRefs": [
                                        "example-value"
                                      ],
                                      "whileExecutingInputRefs": [
                                        "example-value"
                                      ]
                                    }
                                  ],
                                  "instantiate": true,
                                  "ioSpecificationId": "example-value",
                                  "isInterrupting": true,
                                  "isTransaction": true,
                                  "messageRef": "example-value",
                                  "operationRef": "example-value",
                                  "outputSets": [
                                    {
                                      "dataOutputRefs": [
                                        "example-value"
                                      ],
                                      "id": "example-value",
                                      "inputSetRefs": [
                                        "example-value"
                                      ],
                                      "name": "example-value",
                                      "optionalOutputRefs": [
                                        "example-value"
                                      ],
                                      "whileExecutingOutputRefs": [
                                        "example-value"
                                      ]
                                    }
                                  ],
                                  "parallelMultiple": true,
                                  "properties": [
                                    {
                                      "dataState": "example-value",
                                      "id": "example-value",
                                      "itemSubjectRef": "example-value",
                                      "name": "example-value"
                                    }
                                  ],
                                  "resources": [
                                    {
                                      "assignmentExpression": "example-value",
                                      "id": "example-value",
                                      "resourceRef": "example-value",
                                      "role": "example-value"
                                    }
                                  ],
                                  "subProcess": {},
                                  "transactionMethod": "example-value",
                                  "triggeredByEvent": true
                                },
                                "configuration": {},
                                "displayName": "example-value",
                                "id": "example-value",
                                "type": "example-value"
                              }
                            ],
                            "outputSets": [
                              {
                                "dataOutputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "inputSetRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "optionalOutputRefs": [
                                  "example-value"
                                ],
                                "whileExecutingOutputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "processType": "example-value",
                            "properties": [
                              {
                                "dataState": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value"
                              }
                            ],
                            "resources": [
                              {
                                "assignmentExpression": "example-value",
                                "id": "example-value",
                                "resourceRef": "example-value",
                                "role": "example-value"
                              }
                            ],
                            "supports": [
                              "example-value"
                            ]
                          }
                        ],
                        "relationships": [
                          {
                            "direction": "example-value",
                            "id": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "targets": [
                              "example-value"
                            ],
                            "type": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "parameters": [
                              {
                                "id": "example-value",
                                "name": "example-value",
                                "required": true,
                                "type": "example-value"
                              }
                            ]
                          }
                        ],
                        "signals": [
                          {
                            "code": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "structureRef": "example-value"
                          }
                        ],
                        "targetNamespace": "example-value",
                        "typeLanguage": "example-value"
                      },
                      "dmn": {
                        "elements": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "id": "example-value",
                            "name": "example-value",
                            "nodeId": "example-value",
                            "type": "example-value",
                            "typeRef": "example-value",
                            "variableName": "example-value"
                          }
                        ],
                        "fileName": "example-value",
                        "importedDocuments": [
                          {
                            "fileName": "example-value",
                            "namespace": "example-value",
                            "sourceSha256": "example-value",
                            "sourceXml": "example-value"
                          }
                        ],
                        "namespace": "example-value",
                        "requirements": [
                          {
                            "id": "example-value",
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "type": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          }
                        ],
                        "sourceSha256": "example-value",
                        "sourceXml": "example-value",
                        "version": "example-value"
                      },
                      "edges": [
                        {
                          "bpmn": {
                            "assignments": [
                              "example-value"
                            ],
                            "associationDirection": "example-value",
                            "conditionExpression": "example-value",
                            "conditionLanguage": "example-value",
                            "correlationKeyRefs": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "isImmediate": true,
                            "messageRef": "example-value",
                            "name": "example-value",
                            "operationRef": "example-value",
                            "transformation": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          },
                          "branch": "example-value",
                          "condition": {
                            "label": "example-value",
                            "left": "example-value",
                            "on": "example-value",
                            "operator": "example-value",
                            "value": "example-value"
                          },
                          "id": "example-value",
                          "loop": {
                            "carry": {
                              "previousError": true,
                              "previousOutput": true,
                              "reviewerFeedback": true,
                              "validationFeedback": true,
                              "variables": [
                                "example-value"
                              ]
                            },
                            "delaySeconds": 1,
                            "maximumIterations": 1,
                            "onMaximum": {
                              "action": "example-value",
                              "target": "example-value"
                            }
                          },
                          "source": "example-value",
                          "target": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "imports": [
                        {
                          "executable": true,
                          "format": "example-value",
                          "items": [
                            {
                              "configuration": {},
                              "elementId": "example-value",
                              "elementType": "example-value",
                              "message": "example-value",
                              "name": "example-value",
                              "outcome": "example-value",
                              "sourceId": "example-value",
                              "sourceKind": "example-value"
                            }
                          ],
                          "sourceFileName": "example-value",
                          "sourceSha256": "example-value",
                          "version": "example-value"
                        }
                      ],
                      "layout": {
                        "arrangementVersion": 1,
                        "collapsedGroups": {},
                        "nodes": {},
                        "notes": [
                          {
                            "collapsed": true,
                            "id": "example-value",
                            "text": "example-value",
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      },
                      "nodes": [
                        {
                          "bpmn": {
                            "activationCondition": "example-value",
                            "activity": {
                              "cancelRemainingInstances": true,
                              "completionCondition": "example-value",
                              "completionQuantity": 1,
                              "defaultFlow": "example-value",
                              "forCompensation": true,
                              "loop": {
                                "behavior": "example-value",
                                "collection": "example-value",
                                "completionCondition": "example-value",
                                "complexBehaviorDefinitions": [
                                  {
                                    "condition": "example-value",
                                    "eventDefinitions": [
                                      {
                                        "activityRef": "example-value",
                                        "expression": "example-value",
                                        "id": "example-value",
                                        "language": "example-value",
                                        "operationRef": "example-value",
                                        "reference": "example-value",
                                        "sources": [
                                          "example-value"
                                        ],
                                        "target": "example-value",
                                        "timeCycle": "example-value",
                                        "timeDate": "example-value",
                                        "timeDuration": "example-value",
                                        "type": "example-value",
                                        "waitForCompletion": true,
                                        "waitForCompletionSpecified": true
                                      }
                                    ],
                                    "id": "example-value"
                                  }
                                ],
                                "elementVariable": "example-value",
                                "id": "example-value",
                                "kind": "example-value",
                                "loopCondition": "example-value",
                                "loopMaximum": 1,
                                "noneBehaviorEventRef": "example-value",
                                "oneBehaviorEventRef": "example-value",
                                "sequential": true,
                                "testBefore": true
                              },
                              "method": "example-value",
                              "ordering": "example-value",
                              "protocol": "example-value",
                              "renderings": [
                                "example-value"
                              ],
                              "script": "example-value",
                              "scriptFormat": "example-value",
                              "startQuantity": 1
                            },
                            "attachedToRef": "example-value",
                            "calledElement": "example-value",
                            "cancelActivity": true,
                            "dataAssociations": [
                              {
                                "assignmentExpressions": [
                                  {
                                    "from": "example-value",
                                    "fromLanguage": "example-value",
                                    "id": "example-value",
                                    "to": "example-value",
                                    "toLanguage": "example-value"
                                  }
                                ],
                                "assignments": [
                                  "example-value"
                                ],
                                "elementType": "example-value",
                                "id": "example-value",
                                "sources": [
                                  "example-value"
                                ],
                                "target": "example-value",
                                "transformation": "example-value"
                              }
                            ],
                            "dataInputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "dataOutputs": [
                              {
                                "capacity": 1,
                                "collection": true,
                                "dataState": "example-value",
                                "elementType": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value",
                                "originalRef": "example-value",
                                "unlimited": true
                              }
                            ],
                            "defaultFlow": "example-value",
                            "documentation": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "eventDefinitions": [
                              {
                                "activityRef": "example-value",
                                "expression": "example-value",
                                "id": "example-value",
                                "language": "example-value",
                                "operationRef": "example-value",
                                "reference": "example-value",
                                "sources": [
                                  "example-value"
                                ],
                                "target": "example-value",
                                "timeCycle": "example-value",
                                "timeDate": "example-value",
                                "timeDuration": "example-value",
                                "type": "example-value",
                                "waitForCompletion": true,
                                "waitForCompletionSpecified": true
                              }
                            ],
                            "eventGatewayType": "example-value",
                            "extensionXml": [
                              "example-value"
                            ],
                            "gatewayDirection": "example-value",
                            "id": "example-value",
                            "implementation": "example-value",
                            "inputSets": [
                              {
                                "dataInputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "optionalInputRefs": [
                                  "example-value"
                                ],
                                "outputSetRefs": [
                                  "example-value"
                                ],
                                "whileExecutingInputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "instantiate": true,
                            "ioSpecificationId": "example-value",
                            "isInterrupting": true,
                            "isTransaction": true,
                            "messageRef": "example-value",
                            "operationRef": "example-value",
                            "outputSets": [
                              {
                                "dataOutputRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "inputSetRefs": [
                                  "example-value"
                                ],
                                "name": "example-value",
                                "optionalOutputRefs": [
                                  "example-value"
                                ],
                                "whileExecutingOutputRefs": [
                                  "example-value"
                                ]
                              }
                            ],
                            "parallelMultiple": true,
                            "properties": [
                              {
                                "dataState": "example-value",
                                "id": "example-value",
                                "itemSubjectRef": "example-value",
                                "name": "example-value"
                              }
                            ],
                            "resources": [
                              {
                                "assignmentExpression": "example-value",
                                "id": "example-value",
                                "resourceRef": "example-value",
                                "role": "example-value"
                              }
                            ],
                            "subProcess": {
                              "artifacts": [
                                {
                                  "associationDirection": "example-value",
                                  "categoryValueRef": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "name": "example-value",
                                  "position": {
                                    "x": 1.5,
                                    "y": 1.5
                                  },
                                  "sourceRef": "example-value",
                                  "targetRef": "example-value",
                                  "text": "example-value"
                                }
                              ],
                              "auditingXml": "example-value",
                              "closed": true,
                              "correlations": [
                                {
                                  "correlationPropertyRef": "example-value",
                                  "id": "example-value",
                                  "name": "example-value",
                                  "retrievalExpressions": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "dataInputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataObjects": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataOutputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataStores": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "documentation": [
                                "example-value"
                              ],
                              "edges": [
                                {
                                  "bpmn": {
                                    "assignments": [
                                      "example-value"
                                    ],
                                    "associationDirection": "example-value",
                                    "conditionExpression": "example-value",
                                    "conditionLanguage": "example-value",
                                    "correlationKeyRefs": [
                                      "example-value"
                                    ],
                                    "elementType": "example-value",
                                    "isImmediate": true,
                                    "messageRef": "example-value",
                                    "name": "example-value",
                                    "operationRef": "example-value",
                                    "transformation": "example-value",
                                    "waypoints": [
                                      {
                                        "x": 1.5,
                                        "y": 1.5
                                      }
                                    ]
                                  },
                                  "branch": "example-value",
                                  "condition": {
                                    "label": "example-value",
                                    "left": "example-value",
                                    "on": "example-value",
                                    "operator": "example-value",
                                    "value": "example-value"
                                  },
                                  "id": "example-value",
                                  "loop": {
                                    "carry": {
                                      "previousError": true,
                                      "previousOutput": true,
                                      "reviewerFeedback": true,
                                      "validationFeedback": true,
                                      "variables": [
                                        "example-value"
                                      ]
                                    },
                                    "delaySeconds": 1,
                                    "maximumIterations": 1,
                                    "onMaximum": {
                                      "action": "example-value",
                                      "target": "example-value"
                                    }
                                  },
                                  "source": "example-value",
                                  "target": "example-value",
                                  "type": "example-value"
                                }
                              ],
                              "executable": true,
                              "extensionXml": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "inputSets": [
                                {
                                  "dataInputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "optionalInputRefs": [
                                    "example-value"
                                  ],
                                  "outputSetRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingInputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "ioSpecificationId": "example-value",
                              "laneSets": [
                                {
                                  "id": "example-value",
                                  "lanes": [
                                    {
                                      "childLaneSet": {},
                                      "flowNodeRefs": [
                                        "example-value"
                                      ],
                                      "id": "example-value",
                                      "name": "example-value",
                                      "partitionElementRef": "example-value",
                                      "resources": [
                                        {
                                          "assignmentExpression": "example-value",
                                          "id": "example-value",
                                          "resourceRef": "example-value",
                                          "role": "example-value"
                                        }
                                      ]
                                    }
                                  ],
                                  "name": "example-value"
                                }
                              ],
                              "layout": {
                                "arrangementVersion": 1,
                                "collapsedGroups": {},
                                "nodes": {},
                                "notes": [
                                  {
                                    "collapsed": true,
                                    "id": "example-value",
                                    "text": "example-value",
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              },
                              "monitoringXml": "example-value",
                              "name": "example-value",
                              "nodes": [
                                {}
                              ],
                              "outputSets": [
                                {
                                  "dataOutputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "inputSetRefs": [
                                    "example-value"
                                  ],
                                  "name": "example-value",
                                  "optionalOutputRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingOutputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "processType": "example-value",
                              "properties": [
                                {
                                  "dataState": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value"
                                }
                              ],
                              "resources": [
                                {
                                  "assignmentExpression": "example-value",
                                  "id": "example-value",
                                  "resourceRef": "example-value",
                                  "role": "example-value"
                                }
                              ],
                              "supports": [
                                "example-value"
                              ]
                            },
                            "transactionMethod": "example-value",
                            "triggeredByEvent": true
                          },
                          "configuration": {},
                          "displayName": "example-value",
                          "id": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "protection": {
                        "customChecks": [
                          "example-value"
                        ],
                        "preset": "example-value"
                      },
                      "schemaVersion": 1
                    }
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "definition": {
                      "edges": [
                        {
                          "source": "example-value",
                          "target": "example-value"
                        }
                      ],
                      "nodes": [
                        {
                          "configuration": {},
                          "displayName": "example-value",
                          "id": "example-value",
                          "type": "example-value"
                        }
                      ],
                      "schemaVersion": 1
                    }
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "definition": {
                    "$ref": "#/components/schemas/WorkflowDefinitionRequest",
                    "description": "The definition associated with this resource or operation.",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "definition"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Draft workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:347",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "definition": {
                  "bpmn": {
                    "categories": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "values": [
                          {
                            "id": "example-value",
                            "value": "example-value"
                          }
                        ]
                      }
                    ],
                    "choreographies": [
                      {
                        "activities": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "initiatingParticipantRef": "example-value",
                            "loop": {
                              "behavior": "example-value",
                              "collection": "example-value",
                              "completionCondition": "example-value",
                              "complexBehaviorDefinitions": [
                                {
                                  "condition": "example-value",
                                  "eventDefinitions": [
                                    {
                                      "activityRef": "example-value",
                                      "expression": "example-value",
                                      "id": "example-value",
                                      "language": "example-value",
                                      "operationRef": "example-value",
                                      "reference": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "timeCycle": "example-value",
                                      "timeDate": "example-value",
                                      "timeDuration": "example-value",
                                      "type": "example-value",
                                      "waitForCompletion": true,
                                      "waitForCompletionSpecified": true
                                    }
                                  ],
                                  "id": "example-value"
                                }
                              ],
                              "elementVariable": "example-value",
                              "id": "example-value",
                              "kind": "example-value",
                              "loopCondition": "example-value",
                              "loopMaximum": 1,
                              "noneBehaviorEventRef": "example-value",
                              "oneBehaviorEventRef": "example-value",
                              "sequential": true,
                              "testBefore": true
                            },
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "id": "example-value",
                        "initiatingParticipantRef": "example-value",
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "collaborations": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "closed": true,
                        "conversationLinks": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "conversations": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "correlationKeys": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "id": "example-value",
                        "messageFlows": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "conformanceProfile": "example-value",
                    "conversations": [
                      {
                        "calledElementRef": "example-value",
                        "children": [
                          {}
                        ],
                        "elementType": "example-value",
                        "id": "example-value",
                        "messageFlowRefs": [
                          "example-value"
                        ],
                        "name": "example-value",
                        "participantRefs": [
                          "example-value"
                        ]
                      }
                    ],
                    "dataStores": [
                      {
                        "capacity": 1,
                        "collection": true,
                        "dataState": "example-value",
                        "elementType": "example-value",
                        "id": "example-value",
                        "itemSubjectRef": "example-value",
                        "name": "example-value",
                        "originalRef": "example-value",
                        "unlimited": true
                      }
                    ],
                    "diagrams": [
                      {
                        "edges": [
                          {
                            "elementRef": "example-value",
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "messageVisibleKind": "example-value",
                            "sourceElement": "example-value",
                            "targetElement": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          }
                        ],
                        "elementRef": "example-value",
                        "id": "example-value",
                        "labels": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "id": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "orientation": "example-value",
                        "planeId": "example-value",
                        "shapes": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "choreographyActivityShape": "example-value",
                            "elementRef": "example-value",
                            "expanded": true,
                            "horizontal": true,
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "markerVisible": true,
                            "participantBandKind": "example-value"
                          }
                        ]
                      }
                    ],
                    "errors": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "escalations": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "exporter": "example-value",
                    "exporterVersion": "example-value",
                    "expressionLanguage": "example-value",
                    "extensionElementsXml": [
                      "example-value"
                    ],
                    "id": "example-value",
                    "imports": [
                      {
                        "importType": "example-value",
                        "location": "example-value",
                        "namespace": "example-value"
                      }
                    ],
                    "interfaces": [
                      {
                        "id": "example-value",
                        "implementationRef": "example-value",
                        "name": "example-value",
                        "operations": [
                          {
                            "errorRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "implementationRef": "example-value",
                            "inputMessageRef": "example-value",
                            "name": "example-value",
                            "outputMessageRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "itemDefinitions": [
                      {
                        "id": "example-value",
                        "isCollection": true,
                        "itemKind": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "messages": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "name": "example-value",
                    "namespaces": {},
                    "primaryProcessId": "example-value",
                    "processes": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "auditingXml": "example-value",
                        "closed": true,
                        "correlations": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataObjects": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataStores": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "documentation": [
                          "example-value"
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "executable": true,
                        "extensionXml": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "ioSpecificationId": "example-value",
                        "laneSets": [
                          {
                            "id": "example-value",
                            "lanes": [
                              {
                                "childLaneSet": {},
                                "flowNodeRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "partitionElementRef": "example-value",
                                "resources": [
                                  {
                                    "assignmentExpression": "example-value",
                                    "id": "example-value",
                                    "resourceRef": "example-value",
                                    "role": "example-value"
                                  }
                                ]
                              }
                            ],
                            "name": "example-value"
                          }
                        ],
                        "layout": {
                          "arrangementVersion": 1,
                          "collapsedGroups": {},
                          "nodes": {},
                          "notes": [
                            {
                              "collapsed": true,
                              "id": "example-value",
                              "text": "example-value",
                              "x": 1.5,
                              "y": 1.5
                            }
                          ]
                        },
                        "monitoringXml": "example-value",
                        "name": "example-value",
                        "nodes": [
                          {
                            "bpmn": {
                              "activationCondition": "example-value",
                              "activity": {
                                "cancelRemainingInstances": true,
                                "completionCondition": "example-value",
                                "completionQuantity": 1,
                                "defaultFlow": "example-value",
                                "forCompensation": true,
                                "loop": {
                                  "behavior": "example-value",
                                  "collection": "example-value",
                                  "completionCondition": "example-value",
                                  "complexBehaviorDefinitions": [
                                    {
                                      "condition": "example-value",
                                      "eventDefinitions": [
                                        {
                                          "activityRef": "example-value",
                                          "expression": "example-value",
                                          "id": "example-value",
                                          "language": "example-value",
                                          "operationRef": "example-value",
                                          "reference": "example-value",
                                          "sources": [
                                            "example-value"
                                          ],
                                          "target": "example-value",
                                          "timeCycle": "example-value",
                                          "timeDate": "example-value",
                                          "timeDuration": "example-value",
                                          "type": "example-value",
                                          "waitForCompletion": true,
                                          "waitForCompletionSpecified": true
                                        }
                                      ],
                                      "id": "example-value"
                                    }
                                  ],
                                  "elementVariable": "example-value",
                                  "id": "example-value",
                                  "kind": "example-value",
                                  "loopCondition": "example-value",
                                  "loopMaximum": 1,
                                  "noneBehaviorEventRef": "example-value",
                                  "oneBehaviorEventRef": "example-value",
                                  "sequential": true,
                                  "testBefore": true
                                },
                                "method": "example-value",
                                "ordering": "example-value",
                                "protocol": "example-value",
                                "renderings": [
                                  "example-value"
                                ],
                                "script": "example-value",
                                "scriptFormat": "example-value",
                                "startQuantity": 1
                              },
                              "attachedToRef": "example-value",
                              "calledElement": "example-value",
                              "cancelActivity": true,
                              "dataAssociations": [
                                {
                                  "assignmentExpressions": [
                                    {
                                      "from": "example-value",
                                      "fromLanguage": "example-value",
                                      "id": "example-value",
                                      "to": "example-value",
                                      "toLanguage": "example-value"
                                    }
                                  ],
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "transformation": "example-value"
                                }
                              ],
                              "dataInputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataOutputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "defaultFlow": "example-value",
                              "documentation": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "eventDefinitions": [
                                {
                                  "activityRef": "example-value",
                                  "expression": "example-value",
                                  "id": "example-value",
                                  "language": "example-value",
                                  "operationRef": "example-value",
                                  "reference": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "timeCycle": "example-value",
                                  "timeDate": "example-value",
                                  "timeDuration": "example-value",
                                  "type": "example-value",
                                  "waitForCompletion": true,
                                  "waitForCompletionSpecified": true
                                }
                              ],
                              "eventGatewayType": "example-value",
                              "extensionXml": [
                                "example-value"
                              ],
                              "gatewayDirection": "example-value",
                              "id": "example-value",
                              "implementation": "example-value",
                              "inputSets": [
                                {
                                  "dataInputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "optionalInputRefs": [
                                    "example-value"
                                  ],
                                  "outputSetRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingInputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "instantiate": true,
                              "ioSpecificationId": "example-value",
                              "isInterrupting": true,
                              "isTransaction": true,
                              "messageRef": "example-value",
                              "operationRef": "example-value",
                              "outputSets": [
                                {
                                  "dataOutputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "inputSetRefs": [
                                    "example-value"
                                  ],
                                  "name": "example-value",
                                  "optionalOutputRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingOutputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "parallelMultiple": true,
                              "properties": [
                                {
                                  "dataState": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value"
                                }
                              ],
                              "resources": [
                                {
                                  "assignmentExpression": "example-value",
                                  "id": "example-value",
                                  "resourceRef": "example-value",
                                  "role": "example-value"
                                }
                              ],
                              "subProcess": {},
                              "transactionMethod": "example-value",
                              "triggeredByEvent": true
                            },
                            "configuration": {},
                            "displayName": "example-value",
                            "id": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "processType": "example-value",
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "supports": [
                          "example-value"
                        ]
                      }
                    ],
                    "relationships": [
                      {
                        "direction": "example-value",
                        "id": "example-value",
                        "sources": [
                          "example-value"
                        ],
                        "targets": [
                          "example-value"
                        ],
                        "type": "example-value"
                      }
                    ],
                    "resources": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "parameters": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "required": true,
                            "type": "example-value"
                          }
                        ]
                      }
                    ],
                    "signals": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "targetNamespace": "example-value",
                    "typeLanguage": "example-value"
                  },
                  "dmn": {
                    "elements": [
                      {
                        "bounds": {
                          "height": 1.5,
                          "width": 1.5,
                          "x": 1.5,
                          "y": 1.5
                        },
                        "id": "example-value",
                        "name": "example-value",
                        "nodeId": "example-value",
                        "type": "example-value",
                        "typeRef": "example-value",
                        "variableName": "example-value"
                      }
                    ],
                    "fileName": "example-value",
                    "importedDocuments": [
                      {
                        "fileName": "example-value",
                        "namespace": "example-value",
                        "sourceSha256": "example-value",
                        "sourceXml": "example-value"
                      }
                    ],
                    "namespace": "example-value",
                    "requirements": [
                      {
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "targetRef": "example-value",
                        "type": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      }
                    ],
                    "sourceSha256": "example-value",
                    "sourceXml": "example-value",
                    "version": "example-value"
                  },
                  "edges": [
                    {
                      "bpmn": {
                        "assignments": [
                          "example-value"
                        ],
                        "associationDirection": "example-value",
                        "conditionExpression": "example-value",
                        "conditionLanguage": "example-value",
                        "correlationKeyRefs": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "isImmediate": true,
                        "messageRef": "example-value",
                        "name": "example-value",
                        "operationRef": "example-value",
                        "transformation": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      },
                      "branch": "example-value",
                      "condition": {
                        "label": "example-value",
                        "left": "example-value",
                        "on": "example-value",
                        "operator": "example-value",
                        "value": "example-value"
                      },
                      "id": "example-value",
                      "loop": {
                        "carry": {
                          "previousError": true,
                          "previousOutput": true,
                          "reviewerFeedback": true,
                          "validationFeedback": true,
                          "variables": [
                            "example-value"
                          ]
                        },
                        "delaySeconds": 1,
                        "maximumIterations": 1,
                        "onMaximum": {
                          "action": "example-value",
                          "target": "example-value"
                        }
                      },
                      "source": "example-value",
                      "target": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "imports": [
                    {
                      "executable": true,
                      "format": "example-value",
                      "items": [
                        {
                          "configuration": {},
                          "elementId": "example-value",
                          "elementType": "example-value",
                          "message": "example-value",
                          "name": "example-value",
                          "outcome": "example-value",
                          "sourceId": "example-value",
                          "sourceKind": "example-value"
                        }
                      ],
                      "sourceFileName": "example-value",
                      "sourceSha256": "example-value",
                      "version": "example-value"
                    }
                  ],
                  "layout": {
                    "arrangementVersion": 1,
                    "collapsedGroups": {},
                    "nodes": {},
                    "notes": [
                      {
                        "collapsed": true,
                        "id": "example-value",
                        "text": "example-value",
                        "x": 1.5,
                        "y": 1.5
                      }
                    ]
                  },
                  "nodes": [
                    {
                      "bpmn": {
                        "activationCondition": "example-value",
                        "activity": {
                          "cancelRemainingInstances": true,
                          "completionCondition": "example-value",
                          "completionQuantity": 1,
                          "defaultFlow": "example-value",
                          "forCompensation": true,
                          "loop": {
                            "behavior": "example-value",
                            "collection": "example-value",
                            "completionCondition": "example-value",
                            "complexBehaviorDefinitions": [
                              {
                                "condition": "example-value",
                                "eventDefinitions": [
                                  {
                                    "activityRef": "example-value",
                                    "expression": "example-value",
                                    "id": "example-value",
                                    "language": "example-value",
                                    "operationRef": "example-value",
                                    "reference": "example-value",
                                    "sources": [
                                      "example-value"
                                    ],
                                    "target": "example-value",
                                    "timeCycle": "example-value",
                                    "timeDate": "example-value",
                                    "timeDuration": "example-value",
                                    "type": "example-value",
                                    "waitForCompletion": true,
                                    "waitForCompletionSpecified": true
                                  }
                                ],
                                "id": "example-value"
                              }
                            ],
                            "elementVariable": "example-value",
                            "id": "example-value",
                            "kind": "example-value",
                            "loopCondition": "example-value",
                            "loopMaximum": 1,
                            "noneBehaviorEventRef": "example-value",
                            "oneBehaviorEventRef": "example-value",
                            "sequential": true,
                            "testBefore": true
                          },
                          "method": "example-value",
                          "ordering": "example-value",
                          "protocol": "example-value",
                          "renderings": [
                            "example-value"
                          ],
                          "script": "example-value",
                          "scriptFormat": "example-value",
                          "startQuantity": 1
                        },
                        "attachedToRef": "example-value",
                        "calledElement": "example-value",
                        "cancelActivity": true,
                        "dataAssociations": [
                          {
                            "assignmentExpressions": [
                              {
                                "from": "example-value",
                                "fromLanguage": "example-value",
                                "id": "example-value",
                                "to": "example-value",
                                "toLanguage": "example-value"
                              }
                            ],
                            "assignments": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "defaultFlow": "example-value",
                        "documentation": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "eventDefinitions": [
                          {
                            "activityRef": "example-value",
                            "expression": "example-value",
                            "id": "example-value",
                            "language": "example-value",
                            "operationRef": "example-value",
                            "reference": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "timeCycle": "example-value",
                            "timeDate": "example-value",
                            "timeDuration": "example-value",
                            "type": "example-value",
                            "waitForCompletion": true,
                            "waitForCompletionSpecified": true
                          }
                        ],
                        "eventGatewayType": "example-value",
                        "extensionXml": [
                          "example-value"
                        ],
                        "gatewayDirection": "example-value",
                        "id": "example-value",
                        "implementation": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "instantiate": true,
                        "ioSpecificationId": "example-value",
                        "isInterrupting": true,
                        "isTransaction": true,
                        "messageRef": "example-value",
                        "operationRef": "example-value",
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "parallelMultiple": true,
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "subProcess": {
                          "artifacts": [
                            {
                              "associationDirection": "example-value",
                              "categoryValueRef": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "position": {
                                "x": 1.5,
                                "y": 1.5
                              },
                              "sourceRef": "example-value",
                              "targetRef": "example-value",
                              "text": "example-value"
                            }
                          ],
                          "auditingXml": "example-value",
                          "closed": true,
                          "correlations": [
                            {
                              "correlationPropertyRef": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "retrievalExpressions": [
                                "example-value"
                              ]
                            }
                          ],
                          "dataInputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataObjects": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataOutputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataStores": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "documentation": [
                            "example-value"
                          ],
                          "edges": [
                            {
                              "bpmn": {
                                "assignments": [
                                  "example-value"
                                ],
                                "associationDirection": "example-value",
                                "conditionExpression": "example-value",
                                "conditionLanguage": "example-value",
                                "correlationKeyRefs": [
                                  "example-value"
                                ],
                                "elementType": "example-value",
                                "isImmediate": true,
                                "messageRef": "example-value",
                                "name": "example-value",
                                "operationRef": "example-value",
                                "transformation": "example-value",
                                "waypoints": [
                                  {
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              },
                              "branch": "example-value",
                              "condition": {
                                "label": "example-value",
                                "left": "example-value",
                                "on": "example-value",
                                "operator": "example-value",
                                "value": "example-value"
                              },
                              "id": "example-value",
                              "loop": {
                                "carry": {
                                  "previousError": true,
                                  "previousOutput": true,
                                  "reviewerFeedback": true,
                                  "validationFeedback": true,
                                  "variables": [
                                    "example-value"
                                  ]
                                },
                                "delaySeconds": 1,
                                "maximumIterations": 1,
                                "onMaximum": {
                                  "action": "example-value",
                                  "target": "example-value"
                                }
                              },
                              "source": "example-value",
                              "target": "example-value",
                              "type": "example-value"
                            }
                          ],
                          "executable": true,
                          "extensionXml": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "inputSets": [
                            {
                              "dataInputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "name": "example-value",
                              "optionalInputRefs": [
                                "example-value"
                              ],
                              "outputSetRefs": [
                                "example-value"
                              ],
                              "whileExecutingInputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "ioSpecificationId": "example-value",
                          "laneSets": [
                            {
                              "id": "example-value",
                              "lanes": [
                                {
                                  "childLaneSet": {},
                                  "flowNodeRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "partitionElementRef": "example-value",
                                  "resources": [
                                    {
                                      "assignmentExpression": "example-value",
                                      "id": "example-value",
                                      "resourceRef": "example-value",
                                      "role": "example-value"
                                    }
                                  ]
                                }
                              ],
                              "name": "example-value"
                            }
                          ],
                          "layout": {
                            "arrangementVersion": 1,
                            "collapsedGroups": {},
                            "nodes": {},
                            "notes": [
                              {
                                "collapsed": true,
                                "id": "example-value",
                                "text": "example-value",
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          },
                          "monitoringXml": "example-value",
                          "name": "example-value",
                          "nodes": [
                            {}
                          ],
                          "outputSets": [
                            {
                              "dataOutputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "inputSetRefs": [
                                "example-value"
                              ],
                              "name": "example-value",
                              "optionalOutputRefs": [
                                "example-value"
                              ],
                              "whileExecutingOutputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "processType": "example-value",
                          "properties": [
                            {
                              "dataState": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value"
                            }
                          ],
                          "resources": [
                            {
                              "assignmentExpression": "example-value",
                              "id": "example-value",
                              "resourceRef": "example-value",
                              "role": "example-value"
                            }
                          ],
                          "supports": [
                            "example-value"
                          ]
                        },
                        "transactionMethod": "example-value",
                        "triggeredByEvent": true
                      },
                      "configuration": {},
                      "displayName": "example-value",
                      "id": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "protection": {
                    "customChecks": [
                      "example-value"
                    ],
                    "preset": "example-value"
                  },
                  "schemaVersion": 1
                }
              },
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/draft"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "definition": {
                  "bpmn": {
                    "categories": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "values": [
                          {
                            "id": "example-value",
                            "value": "example-value"
                          }
                        ]
                      }
                    ],
                    "choreographies": [
                      {
                        "activities": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "initiatingParticipantRef": "example-value",
                            "loop": {
                              "behavior": "example-value",
                              "collection": "example-value",
                              "completionCondition": "example-value",
                              "complexBehaviorDefinitions": [
                                {
                                  "condition": "example-value",
                                  "eventDefinitions": [
                                    {
                                      "activityRef": "example-value",
                                      "expression": "example-value",
                                      "id": "example-value",
                                      "language": "example-value",
                                      "operationRef": "example-value",
                                      "reference": "example-value",
                                      "sources": [
                                        "example-value"
                                      ],
                                      "target": "example-value",
                                      "timeCycle": "example-value",
                                      "timeDate": "example-value",
                                      "timeDuration": "example-value",
                                      "type": "example-value",
                                      "waitForCompletion": true,
                                      "waitForCompletionSpecified": true
                                    }
                                  ],
                                  "id": "example-value"
                                }
                              ],
                              "elementVariable": "example-value",
                              "id": "example-value",
                              "kind": "example-value",
                              "loopCondition": "example-value",
                              "loopMaximum": 1,
                              "noneBehaviorEventRef": "example-value",
                              "oneBehaviorEventRef": "example-value",
                              "sequential": true,
                              "testBefore": true
                            },
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "id": "example-value",
                        "initiatingParticipantRef": "example-value",
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "collaborations": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "closed": true,
                        "conversationLinks": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "conversations": [
                          {
                            "calledElementRef": "example-value",
                            "children": [
                              {}
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "messageFlowRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "participantRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "correlationKeys": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "id": "example-value",
                        "messageFlows": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "participants": [
                          {
                            "id": "example-value",
                            "multiplicityMaximum": 1,
                            "multiplicityMinimum": 1,
                            "name": "example-value",
                            "partnerEntityRef": "example-value",
                            "partnerRoleRef": "example-value",
                            "processRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "conformanceProfile": "example-value",
                    "conversations": [
                      {
                        "calledElementRef": "example-value",
                        "children": [
                          {}
                        ],
                        "elementType": "example-value",
                        "id": "example-value",
                        "messageFlowRefs": [
                          "example-value"
                        ],
                        "name": "example-value",
                        "participantRefs": [
                          "example-value"
                        ]
                      }
                    ],
                    "dataStores": [
                      {
                        "capacity": 1,
                        "collection": true,
                        "dataState": "example-value",
                        "elementType": "example-value",
                        "id": "example-value",
                        "itemSubjectRef": "example-value",
                        "name": "example-value",
                        "originalRef": "example-value",
                        "unlimited": true
                      }
                    ],
                    "diagrams": [
                      {
                        "edges": [
                          {
                            "elementRef": "example-value",
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "messageVisibleKind": "example-value",
                            "sourceElement": "example-value",
                            "targetElement": "example-value",
                            "waypoints": [
                              {
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          }
                        ],
                        "elementRef": "example-value",
                        "id": "example-value",
                        "labels": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "id": "example-value"
                          }
                        ],
                        "name": "example-value",
                        "orientation": "example-value",
                        "planeId": "example-value",
                        "shapes": [
                          {
                            "bounds": {
                              "height": 1.5,
                              "width": 1.5,
                              "x": 1.5,
                              "y": 1.5
                            },
                            "choreographyActivityShape": "example-value",
                            "elementRef": "example-value",
                            "expanded": true,
                            "horizontal": true,
                            "id": "example-value",
                            "label": {
                              "bounds": {
                                "height": 1.5,
                                "width": 1.5,
                                "x": 1.5,
                                "y": 1.5
                              },
                              "id": "example-value"
                            },
                            "markerVisible": true,
                            "participantBandKind": "example-value"
                          }
                        ]
                      }
                    ],
                    "errors": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "escalations": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "exporter": "example-value",
                    "exporterVersion": "example-value",
                    "expressionLanguage": "example-value",
                    "extensionElementsXml": [
                      "example-value"
                    ],
                    "id": "example-value",
                    "imports": [
                      {
                        "importType": "example-value",
                        "location": "example-value",
                        "namespace": "example-value"
                      }
                    ],
                    "interfaces": [
                      {
                        "id": "example-value",
                        "implementationRef": "example-value",
                        "name": "example-value",
                        "operations": [
                          {
                            "errorRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "implementationRef": "example-value",
                            "inputMessageRef": "example-value",
                            "name": "example-value",
                            "outputMessageRef": "example-value"
                          }
                        ]
                      }
                    ],
                    "itemDefinitions": [
                      {
                        "id": "example-value",
                        "isCollection": true,
                        "itemKind": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "messages": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "name": "example-value",
                    "namespaces": {},
                    "primaryProcessId": "example-value",
                    "processes": [
                      {
                        "artifacts": [
                          {
                            "associationDirection": "example-value",
                            "categoryValueRef": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "position": {
                              "x": 1.5,
                              "y": 1.5
                            },
                            "sourceRef": "example-value",
                            "targetRef": "example-value",
                            "text": "example-value"
                          }
                        ],
                        "auditingXml": "example-value",
                        "closed": true,
                        "correlations": [
                          {
                            "correlationPropertyRef": "example-value",
                            "id": "example-value",
                            "name": "example-value",
                            "retrievalExpressions": [
                              "example-value"
                            ]
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataObjects": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataStores": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "documentation": [
                          "example-value"
                        ],
                        "edges": [
                          {
                            "bpmn": {
                              "assignments": [
                                "example-value"
                              ],
                              "associationDirection": "example-value",
                              "conditionExpression": "example-value",
                              "conditionLanguage": "example-value",
                              "correlationKeyRefs": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "isImmediate": true,
                              "messageRef": "example-value",
                              "name": "example-value",
                              "operationRef": "example-value",
                              "transformation": "example-value",
                              "waypoints": [
                                {
                                  "x": 1.5,
                                  "y": 1.5
                                }
                              ]
                            },
                            "branch": "example-value",
                            "condition": {
                              "label": "example-value",
                              "left": "example-value",
                              "on": "example-value",
                              "operator": "example-value",
                              "value": "example-value"
                            },
                            "id": "example-value",
                            "loop": {
                              "carry": {
                                "previousError": true,
                                "previousOutput": true,
                                "reviewerFeedback": true,
                                "validationFeedback": true,
                                "variables": [
                                  "example-value"
                                ]
                              },
                              "delaySeconds": 1,
                              "maximumIterations": 1,
                              "onMaximum": {
                                "action": "example-value",
                                "target": "example-value"
                              }
                            },
                            "source": "example-value",
                            "target": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "executable": true,
                        "extensionXml": [
                          "example-value"
                        ],
                        "id": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "ioSpecificationId": "example-value",
                        "laneSets": [
                          {
                            "id": "example-value",
                            "lanes": [
                              {
                                "childLaneSet": {},
                                "flowNodeRefs": [
                                  "example-value"
                                ],
                                "id": "example-value",
                                "name": "example-value",
                                "partitionElementRef": "example-value",
                                "resources": [
                                  {
                                    "assignmentExpression": "example-value",
                                    "id": "example-value",
                                    "resourceRef": "example-value",
                                    "role": "example-value"
                                  }
                                ]
                              }
                            ],
                            "name": "example-value"
                          }
                        ],
                        "layout": {
                          "arrangementVersion": 1,
                          "collapsedGroups": {},
                          "nodes": {},
                          "notes": [
                            {
                              "collapsed": true,
                              "id": "example-value",
                              "text": "example-value",
                              "x": 1.5,
                              "y": 1.5
                            }
                          ]
                        },
                        "monitoringXml": "example-value",
                        "name": "example-value",
                        "nodes": [
                          {
                            "bpmn": {
                              "activationCondition": "example-value",
                              "activity": {
                                "cancelRemainingInstances": true,
                                "completionCondition": "example-value",
                                "completionQuantity": 1,
                                "defaultFlow": "example-value",
                                "forCompensation": true,
                                "loop": {
                                  "behavior": "example-value",
                                  "collection": "example-value",
                                  "completionCondition": "example-value",
                                  "complexBehaviorDefinitions": [
                                    {
                                      "condition": "example-value",
                                      "eventDefinitions": [
                                        {
                                          "activityRef": "example-value",
                                          "expression": "example-value",
                                          "id": "example-value",
                                          "language": "example-value",
                                          "operationRef": "example-value",
                                          "reference": "example-value",
                                          "sources": [
                                            "example-value"
                                          ],
                                          "target": "example-value",
                                          "timeCycle": "example-value",
                                          "timeDate": "example-value",
                                          "timeDuration": "example-value",
                                          "type": "example-value",
                                          "waitForCompletion": true,
                                          "waitForCompletionSpecified": true
                                        }
                                      ],
                                      "id": "example-value"
                                    }
                                  ],
                                  "elementVariable": "example-value",
                                  "id": "example-value",
                                  "kind": "example-value",
                                  "loopCondition": "example-value",
                                  "loopMaximum": 1,
                                  "noneBehaviorEventRef": "example-value",
                                  "oneBehaviorEventRef": "example-value",
                                  "sequential": true,
                                  "testBefore": true
                                },
                                "method": "example-value",
                                "ordering": "example-value",
                                "protocol": "example-value",
                                "renderings": [
                                  "example-value"
                                ],
                                "script": "example-value",
                                "scriptFormat": "example-value",
                                "startQuantity": 1
                              },
                              "attachedToRef": "example-value",
                              "calledElement": "example-value",
                              "cancelActivity": true,
                              "dataAssociations": [
                                {
                                  "assignmentExpressions": [
                                    {
                                      "from": "example-value",
                                      "fromLanguage": "example-value",
                                      "id": "example-value",
                                      "to": "example-value",
                                      "toLanguage": "example-value"
                                    }
                                  ],
                                  "assignments": [
                                    "example-value"
                                  ],
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "transformation": "example-value"
                                }
                              ],
                              "dataInputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "dataOutputs": [
                                {
                                  "capacity": 1,
                                  "collection": true,
                                  "dataState": "example-value",
                                  "elementType": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value",
                                  "originalRef": "example-value",
                                  "unlimited": true
                                }
                              ],
                              "defaultFlow": "example-value",
                              "documentation": [
                                "example-value"
                              ],
                              "elementType": "example-value",
                              "eventDefinitions": [
                                {
                                  "activityRef": "example-value",
                                  "expression": "example-value",
                                  "id": "example-value",
                                  "language": "example-value",
                                  "operationRef": "example-value",
                                  "reference": "example-value",
                                  "sources": [
                                    "example-value"
                                  ],
                                  "target": "example-value",
                                  "timeCycle": "example-value",
                                  "timeDate": "example-value",
                                  "timeDuration": "example-value",
                                  "type": "example-value",
                                  "waitForCompletion": true,
                                  "waitForCompletionSpecified": true
                                }
                              ],
                              "eventGatewayType": "example-value",
                              "extensionXml": [
                                "example-value"
                              ],
                              "gatewayDirection": "example-value",
                              "id": "example-value",
                              "implementation": "example-value",
                              "inputSets": [
                                {
                                  "dataInputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "optionalInputRefs": [
                                    "example-value"
                                  ],
                                  "outputSetRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingInputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "instantiate": true,
                              "ioSpecificationId": "example-value",
                              "isInterrupting": true,
                              "isTransaction": true,
                              "messageRef": "example-value",
                              "operationRef": "example-value",
                              "outputSets": [
                                {
                                  "dataOutputRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "inputSetRefs": [
                                    "example-value"
                                  ],
                                  "name": "example-value",
                                  "optionalOutputRefs": [
                                    "example-value"
                                  ],
                                  "whileExecutingOutputRefs": [
                                    "example-value"
                                  ]
                                }
                              ],
                              "parallelMultiple": true,
                              "properties": [
                                {
                                  "dataState": "example-value",
                                  "id": "example-value",
                                  "itemSubjectRef": "example-value",
                                  "name": "example-value"
                                }
                              ],
                              "resources": [
                                {
                                  "assignmentExpression": "example-value",
                                  "id": "example-value",
                                  "resourceRef": "example-value",
                                  "role": "example-value"
                                }
                              ],
                              "subProcess": {},
                              "transactionMethod": "example-value",
                              "triggeredByEvent": true
                            },
                            "configuration": {},
                            "displayName": "example-value",
                            "id": "example-value",
                            "type": "example-value"
                          }
                        ],
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "processType": "example-value",
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "supports": [
                          "example-value"
                        ]
                      }
                    ],
                    "relationships": [
                      {
                        "direction": "example-value",
                        "id": "example-value",
                        "sources": [
                          "example-value"
                        ],
                        "targets": [
                          "example-value"
                        ],
                        "type": "example-value"
                      }
                    ],
                    "resources": [
                      {
                        "id": "example-value",
                        "name": "example-value",
                        "parameters": [
                          {
                            "id": "example-value",
                            "name": "example-value",
                            "required": true,
                            "type": "example-value"
                          }
                        ]
                      }
                    ],
                    "signals": [
                      {
                        "code": "example-value",
                        "id": "example-value",
                        "name": "example-value",
                        "structureRef": "example-value"
                      }
                    ],
                    "targetNamespace": "example-value",
                    "typeLanguage": "example-value"
                  },
                  "dmn": {
                    "elements": [
                      {
                        "bounds": {
                          "height": 1.5,
                          "width": 1.5,
                          "x": 1.5,
                          "y": 1.5
                        },
                        "id": "example-value",
                        "name": "example-value",
                        "nodeId": "example-value",
                        "type": "example-value",
                        "typeRef": "example-value",
                        "variableName": "example-value"
                      }
                    ],
                    "fileName": "example-value",
                    "importedDocuments": [
                      {
                        "fileName": "example-value",
                        "namespace": "example-value",
                        "sourceSha256": "example-value",
                        "sourceXml": "example-value"
                      }
                    ],
                    "namespace": "example-value",
                    "requirements": [
                      {
                        "id": "example-value",
                        "sourceRef": "example-value",
                        "targetRef": "example-value",
                        "type": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      }
                    ],
                    "sourceSha256": "example-value",
                    "sourceXml": "example-value",
                    "version": "example-value"
                  },
                  "edges": [
                    {
                      "bpmn": {
                        "assignments": [
                          "example-value"
                        ],
                        "associationDirection": "example-value",
                        "conditionExpression": "example-value",
                        "conditionLanguage": "example-value",
                        "correlationKeyRefs": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "isImmediate": true,
                        "messageRef": "example-value",
                        "name": "example-value",
                        "operationRef": "example-value",
                        "transformation": "example-value",
                        "waypoints": [
                          {
                            "x": 1.5,
                            "y": 1.5
                          }
                        ]
                      },
                      "branch": "example-value",
                      "condition": {
                        "label": "example-value",
                        "left": "example-value",
                        "on": "example-value",
                        "operator": "example-value",
                        "value": "example-value"
                      },
                      "id": "example-value",
                      "loop": {
                        "carry": {
                          "previousError": true,
                          "previousOutput": true,
                          "reviewerFeedback": true,
                          "validationFeedback": true,
                          "variables": [
                            "example-value"
                          ]
                        },
                        "delaySeconds": 1,
                        "maximumIterations": 1,
                        "onMaximum": {
                          "action": "example-value",
                          "target": "example-value"
                        }
                      },
                      "source": "example-value",
                      "target": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "imports": [
                    {
                      "executable": true,
                      "format": "example-value",
                      "items": [
                        {
                          "configuration": {},
                          "elementId": "example-value",
                          "elementType": "example-value",
                          "message": "example-value",
                          "name": "example-value",
                          "outcome": "example-value",
                          "sourceId": "example-value",
                          "sourceKind": "example-value"
                        }
                      ],
                      "sourceFileName": "example-value",
                      "sourceSha256": "example-value",
                      "version": "example-value"
                    }
                  ],
                  "layout": {
                    "arrangementVersion": 1,
                    "collapsedGroups": {},
                    "nodes": {},
                    "notes": [
                      {
                        "collapsed": true,
                        "id": "example-value",
                        "text": "example-value",
                        "x": 1.5,
                        "y": 1.5
                      }
                    ]
                  },
                  "nodes": [
                    {
                      "bpmn": {
                        "activationCondition": "example-value",
                        "activity": {
                          "cancelRemainingInstances": true,
                          "completionCondition": "example-value",
                          "completionQuantity": 1,
                          "defaultFlow": "example-value",
                          "forCompensation": true,
                          "loop": {
                            "behavior": "example-value",
                            "collection": "example-value",
                            "completionCondition": "example-value",
                            "complexBehaviorDefinitions": [
                              {
                                "condition": "example-value",
                                "eventDefinitions": [
                                  {
                                    "activityRef": "example-value",
                                    "expression": "example-value",
                                    "id": "example-value",
                                    "language": "example-value",
                                    "operationRef": "example-value",
                                    "reference": "example-value",
                                    "sources": [
                                      "example-value"
                                    ],
                                    "target": "example-value",
                                    "timeCycle": "example-value",
                                    "timeDate": "example-value",
                                    "timeDuration": "example-value",
                                    "type": "example-value",
                                    "waitForCompletion": true,
                                    "waitForCompletionSpecified": true
                                  }
                                ],
                                "id": "example-value"
                              }
                            ],
                            "elementVariable": "example-value",
                            "id": "example-value",
                            "kind": "example-value",
                            "loopCondition": "example-value",
                            "loopMaximum": 1,
                            "noneBehaviorEventRef": "example-value",
                            "oneBehaviorEventRef": "example-value",
                            "sequential": true,
                            "testBefore": true
                          },
                          "method": "example-value",
                          "ordering": "example-value",
                          "protocol": "example-value",
                          "renderings": [
                            "example-value"
                          ],
                          "script": "example-value",
                          "scriptFormat": "example-value",
                          "startQuantity": 1
                        },
                        "attachedToRef": "example-value",
                        "calledElement": "example-value",
                        "cancelActivity": true,
                        "dataAssociations": [
                          {
                            "assignmentExpressions": [
                              {
                                "from": "example-value",
                                "fromLanguage": "example-value",
                                "id": "example-value",
                                "to": "example-value",
                                "toLanguage": "example-value"
                              }
                            ],
                            "assignments": [
                              "example-value"
                            ],
                            "elementType": "example-value",
                            "id": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "transformation": "example-value"
                          }
                        ],
                        "dataInputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "dataOutputs": [
                          {
                            "capacity": 1,
                            "collection": true,
                            "dataState": "example-value",
                            "elementType": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value",
                            "originalRef": "example-value",
                            "unlimited": true
                          }
                        ],
                        "defaultFlow": "example-value",
                        "documentation": [
                          "example-value"
                        ],
                        "elementType": "example-value",
                        "eventDefinitions": [
                          {
                            "activityRef": "example-value",
                            "expression": "example-value",
                            "id": "example-value",
                            "language": "example-value",
                            "operationRef": "example-value",
                            "reference": "example-value",
                            "sources": [
                              "example-value"
                            ],
                            "target": "example-value",
                            "timeCycle": "example-value",
                            "timeDate": "example-value",
                            "timeDuration": "example-value",
                            "type": "example-value",
                            "waitForCompletion": true,
                            "waitForCompletionSpecified": true
                          }
                        ],
                        "eventGatewayType": "example-value",
                        "extensionXml": [
                          "example-value"
                        ],
                        "gatewayDirection": "example-value",
                        "id": "example-value",
                        "implementation": "example-value",
                        "inputSets": [
                          {
                            "dataInputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "name": "example-value",
                            "optionalInputRefs": [
                              "example-value"
                            ],
                            "outputSetRefs": [
                              "example-value"
                            ],
                            "whileExecutingInputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "instantiate": true,
                        "ioSpecificationId": "example-value",
                        "isInterrupting": true,
                        "isTransaction": true,
                        "messageRef": "example-value",
                        "operationRef": "example-value",
                        "outputSets": [
                          {
                            "dataOutputRefs": [
                              "example-value"
                            ],
                            "id": "example-value",
                            "inputSetRefs": [
                              "example-value"
                            ],
                            "name": "example-value",
                            "optionalOutputRefs": [
                              "example-value"
                            ],
                            "whileExecutingOutputRefs": [
                              "example-value"
                            ]
                          }
                        ],
                        "parallelMultiple": true,
                        "properties": [
                          {
                            "dataState": "example-value",
                            "id": "example-value",
                            "itemSubjectRef": "example-value",
                            "name": "example-value"
                          }
                        ],
                        "resources": [
                          {
                            "assignmentExpression": "example-value",
                            "id": "example-value",
                            "resourceRef": "example-value",
                            "role": "example-value"
                          }
                        ],
                        "subProcess": {
                          "artifacts": [
                            {
                              "associationDirection": "example-value",
                              "categoryValueRef": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "position": {
                                "x": 1.5,
                                "y": 1.5
                              },
                              "sourceRef": "example-value",
                              "targetRef": "example-value",
                              "text": "example-value"
                            }
                          ],
                          "auditingXml": "example-value",
                          "closed": true,
                          "correlations": [
                            {
                              "correlationPropertyRef": "example-value",
                              "id": "example-value",
                              "name": "example-value",
                              "retrievalExpressions": [
                                "example-value"
                              ]
                            }
                          ],
                          "dataInputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataObjects": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataOutputs": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "dataStores": [
                            {
                              "capacity": 1,
                              "collection": true,
                              "dataState": "example-value",
                              "elementType": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value",
                              "originalRef": "example-value",
                              "unlimited": true
                            }
                          ],
                          "documentation": [
                            "example-value"
                          ],
                          "edges": [
                            {
                              "bpmn": {
                                "assignments": [
                                  "example-value"
                                ],
                                "associationDirection": "example-value",
                                "conditionExpression": "example-value",
                                "conditionLanguage": "example-value",
                                "correlationKeyRefs": [
                                  "example-value"
                                ],
                                "elementType": "example-value",
                                "isImmediate": true,
                                "messageRef": "example-value",
                                "name": "example-value",
                                "operationRef": "example-value",
                                "transformation": "example-value",
                                "waypoints": [
                                  {
                                    "x": 1.5,
                                    "y": 1.5
                                  }
                                ]
                              },
                              "branch": "example-value",
                              "condition": {
                                "label": "example-value",
                                "left": "example-value",
                                "on": "example-value",
                                "operator": "example-value",
                                "value": "example-value"
                              },
                              "id": "example-value",
                              "loop": {
                                "carry": {
                                  "previousError": true,
                                  "previousOutput": true,
                                  "reviewerFeedback": true,
                                  "validationFeedback": true,
                                  "variables": [
                                    "example-value"
                                  ]
                                },
                                "delaySeconds": 1,
                                "maximumIterations": 1,
                                "onMaximum": {
                                  "action": "example-value",
                                  "target": "example-value"
                                }
                              },
                              "source": "example-value",
                              "target": "example-value",
                              "type": "example-value"
                            }
                          ],
                          "executable": true,
                          "extensionXml": [
                            "example-value"
                          ],
                          "id": "example-value",
                          "inputSets": [
                            {
                              "dataInputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "name": "example-value",
                              "optionalInputRefs": [
                                "example-value"
                              ],
                              "outputSetRefs": [
                                "example-value"
                              ],
                              "whileExecutingInputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "ioSpecificationId": "example-value",
                          "laneSets": [
                            {
                              "id": "example-value",
                              "lanes": [
                                {
                                  "childLaneSet": {},
                                  "flowNodeRefs": [
                                    "example-value"
                                  ],
                                  "id": "example-value",
                                  "name": "example-value",
                                  "partitionElementRef": "example-value",
                                  "resources": [
                                    {
                                      "assignmentExpression": "example-value",
                                      "id": "example-value",
                                      "resourceRef": "example-value",
                                      "role": "example-value"
                                    }
                                  ]
                                }
                              ],
                              "name": "example-value"
                            }
                          ],
                          "layout": {
                            "arrangementVersion": 1,
                            "collapsedGroups": {},
                            "nodes": {},
                            "notes": [
                              {
                                "collapsed": true,
                                "id": "example-value",
                                "text": "example-value",
                                "x": 1.5,
                                "y": 1.5
                              }
                            ]
                          },
                          "monitoringXml": "example-value",
                          "name": "example-value",
                          "nodes": [
                            {}
                          ],
                          "outputSets": [
                            {
                              "dataOutputRefs": [
                                "example-value"
                              ],
                              "id": "example-value",
                              "inputSetRefs": [
                                "example-value"
                              ],
                              "name": "example-value",
                              "optionalOutputRefs": [
                                "example-value"
                              ],
                              "whileExecutingOutputRefs": [
                                "example-value"
                              ]
                            }
                          ],
                          "processType": "example-value",
                          "properties": [
                            {
                              "dataState": "example-value",
                              "id": "example-value",
                              "itemSubjectRef": "example-value",
                              "name": "example-value"
                            }
                          ],
                          "resources": [
                            {
                              "assignmentExpression": "example-value",
                              "id": "example-value",
                              "resourceRef": "example-value",
                              "role": "example-value"
                            }
                          ],
                          "supports": [
                            "example-value"
                          ]
                        },
                        "transactionMethod": "example-value",
                        "triggeredByEvent": true
                      },
                      "configuration": {},
                      "displayName": "example-value",
                      "id": "example-value",
                      "type": "example-value"
                    }
                  ],
                  "protection": {
                    "customChecks": [
                      "example-value"
                    ],
                    "preset": "example-value"
                  },
                  "schemaVersion": 1
                }
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/draft"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/draft"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Draft workflows. This replaces or sets the selected state using the full supplied value.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/workflows/{workflowId}/export/bpel": {
      "get": {
        "description": "### Purpose\nGet workflows export. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdExportBpel",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows export",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:470",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/bpel"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/bpel"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/bpel"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows export. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/{workflowId}/export/bpmn": {
      "get": {
        "description": "### Purpose\nGet workflows export. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdExportBpmn",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows export",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:438",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/bpmn"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/bpmn"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/bpmn"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows export. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/{workflowId}/export/dmn": {
      "get": {
        "description": "### Purpose\nGet workflows export. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdExportDmn",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows export",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:454",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/dmn"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/dmn"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/export/dmn"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows export. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/{workflowId}/import-source": {
      "get": {
        "description": "### Purpose\nGet workflows import source. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdImportSource",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "2026-08-28T00:00:00Z",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "workflow-import-format": {
                    "summary": "Choose the BPMN or DMN source to download.",
                    "value": {
                      "error": {
                        "code": "WORKFLOW_IMPORT_FORMAT",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Choose the BPMN or DMN source to download."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows import source",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:486",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "Choose the BPMN or DMN source to download.",
            "code": "WORKFLOW_IMPORT_FORMAT",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/import-source"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/import-source"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/import-source"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows import source. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/{workflowId}/publish": {
      "post": {
        "description": "### Purpose\nPublish workflows. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiWorkflowsWorkflowIdPublish",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Publish workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "publish",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:411",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "workflow.published"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/workflows/example-workflowId/publish"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/publish"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/workflows/example-workflowId/publish"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Publish workflows. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/workflows/{workflowId}/runs": {
      "get": {
        "description": "### Purpose\nGet workflows runs. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdRuns",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "active",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "threadId",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "example-threadid",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          },
          {
            "description": "Optional query value used to narrow or control the result.",
            "in": "query",
            "name": "waitKind",
            "required": false,
            "schema": {
              "description": "Optional query value used to narrow or control the result.",
              "example": "example-value",
              "type": "string",
              "x-punaha-access": "Inherits the operation access rules.",
              "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
              "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
              "x-punaha-empty": "The field may be omitted. Omission is different from null, an empty string, an empty collection, zero, or false.",
              "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Provided by the caller and validated by Pūnaha."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": [
                        {
                          "approvalRequest": "example-value",
                          "completedAt": "2026-08-28T00:00:00Z",
                          "createdAt": "2026-08-28T00:00:00Z",
                          "createdBy": "example-value",
                          "errorCode": "example-value",
                          "errorMessage": "example-value",
                          "id": "example-value",
                          "input": "example-value",
                          "isDraftTest": true,
                          "organizationId": "example-value",
                          "output": "example-value",
                          "priority": "example-value",
                          "resumeAt": "2026-08-28T00:00:00Z",
                          "runKind": "example-value",
                          "serverId": "example-value",
                          "startedAt": "2026-08-28T00:00:00Z",
                          "state": "example-value",
                          "stateRevision": 1,
                          "status": "example-value",
                          "threadId": "example-value",
                          "updatedAt": "2026-08-28T00:00:00Z",
                          "waitKind": "example-value",
                          "waitingNodeId": "example-value",
                          "workflowId": "example-value",
                          "workflowVersion": 1
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "The operation-specific result.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/HttpapiworkflowRunViewResponse"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows runs",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:507",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows runs. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      },
      "post": {
        "description": "### Purpose\nRuns workflows. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiWorkflowsWorkflowIdRuns",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "attachments": [
                      {
                        "contentBase64": "example-value",
                        "contentType": "example-value",
                        "fileName": "example-value"
                      }
                    ],
                    "draftTest": true,
                    "messages": [
                      {}
                    ],
                    "priority": "example-value",
                    "runKind": "example-value",
                    "threadId": "example-value",
                    "trigger": {},
                    "variables": {},
                    "version": 1
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "messages": [
                      {}
                    ],
                    "variables": {}
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/WorkflowRunInputRequest"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The request was accepted for background processing; use the documented status operation to monitor it.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Runs workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:521",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "attachments": [
                  {
                    "contentBase64": "example-value",
                    "contentType": "example-value",
                    "fileName": "example-value"
                  }
                ],
                "draftTest": true,
                "messages": [
                  {}
                ],
                "priority": "example-value",
                "runKind": "example-value",
                "threadId": "example-value",
                "trigger": {},
                "variables": {},
                "version": 1
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs"
            },
            "response": {
              "status": "202"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "attachments": [
                  {
                    "contentBase64": "example-value",
                    "contentType": "example-value",
                    "fileName": "example-value"
                  }
                ],
                "draftTest": true,
                "messages": [
                  {}
                ],
                "priority": "example-value",
                "runKind": "example-value",
                "threadId": "example-value",
                "trigger": {},
                "variables": {},
                "version": 1
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs"
            },
            "response": {
              "status": "202"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Runs workflows. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/workflows/{workflowId}/runs/{runId}": {
      "delete": {
        "description": "### Purpose\nDelete workflows. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The run id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "runId",
            "required": true,
            "schema": {
              "description": "The run id that identifies the resource selected by this operation.",
              "example": "example-runid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:628",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId/runs/example-runId"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId/runs/example-runId"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId/runs/example-runId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete workflows. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnProfilesCommonExecutable",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "get": {
        "description": "### Purpose\nGet workflows runs. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdRunsRunId",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The run id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "runId",
            "required": true,
            "schema": {
              "description": "The run id that identifies the resource selected by this operation.",
              "example": "example-runid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": {
                        "approvalRequest": "example-value",
                        "completedAt": "2026-08-28T00:00:00Z",
                        "createdAt": "2026-08-28T00:00:00Z",
                        "createdBy": "example-value",
                        "errorCode": "example-value",
                        "errorMessage": "example-value",
                        "id": "example-value",
                        "input": "example-value",
                        "isDraftTest": true,
                        "organizationId": "example-value",
                        "output": "example-value",
                        "priority": "example-value",
                        "resumeAt": "2026-08-28T00:00:00Z",
                        "runKind": "example-value",
                        "serverId": "example-value",
                        "startedAt": "2026-08-28T00:00:00Z",
                        "state": "example-value",
                        "stateRevision": 1,
                        "status": "example-value",
                        "threadId": "example-value",
                        "updatedAt": "2026-08-28T00:00:00Z",
                        "waitKind": "example-value",
                        "waitingNodeId": "example-value",
                        "workflowId": "example-value",
                        "workflowVersion": 1
                      }
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/HttpapiworkflowRunViewResponse",
                      "description": "The operation-specific result.",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows runs",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:539",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows runs. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/{workflowId}/runs/{runId}/decision": {
      "post": {
        "description": "### Purpose\nDecision workflows. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiWorkflowsWorkflowIdRunsRunIdDecision",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The run id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "runId",
            "required": true,
            "schema": {
              "description": "The run id that identifies the resource selected by this operation.",
              "example": "example-runid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "decision": "example-value",
                    "feedback": "example-value",
                    "nodeId": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "decision": "example-value",
                    "feedback": "example-value",
                    "nodeId": "example-value"
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "decision": {
                    "description": "The decision associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "feedback": {
                    "description": "The feedback associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  },
                  "nodeId": {
                    "description": "The node id associated with this resource or operation.",
                    "example": "example-value",
                    "type": "string",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "decision",
                  "feedback",
                  "nodeId"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Decision workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:570",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "decision": "example-value",
                "feedback": "example-value",
                "nodeId": "example-value"
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs/example-runId/decision"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "decision": "example-value",
                "feedback": "example-value",
                "nodeId": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs/example-runId/decision"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs/example-runId/decision"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Decision workflows. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/workflows/{workflowId}/runs/{runId}/events": {
      "get": {
        "description": "### Purpose\nGet workflows events. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdRunsRunIdEvents",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The run id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "runId",
            "required": true,
            "schema": {
              "description": "The run id that identifies the resource selected by this operation.",
              "example": "example-runid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows events",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:552",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId/events"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId/events"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId/events"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows events. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/api/workflows/{workflowId}/runs/{runId}/events/stream": {
      "get": {
        "description": "### Purpose\nGet workflows events. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this while monitoring a run when a streamed terminal or waiting-state update is more appropriate than repeated polling.\n\n### When not to use it\nDo not use this as a historical event query or assume replay beyond the documented stream lifecycle; read the run or event-list operation instead.",
        "operationId": "getapiWorkflowsWorkflowIdRunsRunIdEventsStream",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The run id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "runId",
            "required": true,
            "schema": {
              "description": "The run id that identifies the resource selected by this operation.",
              "example": "example-runid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "Return stored workflow events whose numeric ID is greater than this cursor. Use the id of the last workflow.event frame received. Omission or an invalid integer uses zero. This handler reads the after query parameter, not the Last-Event-ID header. Snapshots have no event ID.",
            "in": "query",
            "name": "after",
            "required": false,
            "schema": {
              "default": 0,
              "example": 0,
              "format": "int64",
              "type": "integer",
              "x-punaha-empty": "Omission, an empty value or an invalid integer uses zero.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "description": "`workflow.event` carries a stored workflow event as JSON in its data string and a numeric string id. `run.snapshot` carries the direct current run representation as JSON without a data envelope or an event ID. Reconnect deliberately with `?after=<last numeric event id>` to read later stored events. The handler does not read `Last-Event-ID`. Waiting snapshots are sent when their contents change. Approval waits and completed, failed or cancelled runs close the stream after the snapshot. Other wait kinds keep the stream open. The stream also closes after ten minutes or client disconnection. Closing the connection stops observation and does not cancel the workflow run.",
                "examples": {
                  "runSnapshot": {
                    "summary": "Completed run snapshot without an envelope or event ID",
                    "value": {
                      "data": "{\"createdAt\":\"2026-08-28T00:00:00Z\",\"id\":\"example-run-id\",\"input\":\"example-value\",\"isDraftTest\":true,\"organizationId\":\"example-value\",\"priority\":\"example-value\",\"runKind\":\"example-value\",\"state\":\"example-value\",\"stateRevision\":1,\"status\":\"completed\",\"threadId\":\"example-value\",\"updatedAt\":\"2026-08-28T00:00:00Z\",\"workflowId\":\"example-value\",\"workflowVersion\":1}",
                      "event": "run.snapshot"
                    }
                  },
                  "workflowEvent": {
                    "summary": "Stored workflow event with a numeric cursor",
                    "value": {
                      "data": "{\"createdAt\":\"2026-08-28T00:00:00Z\",\"data\":{\"output\":{\"content\":\"Finished\"}},\"id\":78,\"runId\":\"example-run-id\",\"type\":\"run.completed\"}",
                      "event": "workflow.event",
                      "id": "78"
                    }
                  }
                },
                "itemSchema": {
                  "$ref": "#/components/schemas/WorkflowServerSentEvent"
                }
              }
            },
            "description": "An SSE stream of workflow events and waiting or terminal run snapshots.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  },
                  "stream-unavailable": {
                    "summary": "HTTP streaming is unavailable.",
                    "value": {
                      "error": {
                        "code": "STREAM_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: STREAM_UNAVAILABLE."
                        },
                        "message": "HTTP streaming is unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows events",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:569",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "HTTP streaming is unavailable.",
            "code": "STREAM_UNAVAILABLE",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: STREAM_UNAVAILABLE.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId/events/stream"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId/events/stream"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/runs/example-runId/events/stream"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows events. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a historical event query or assume replay beyond the documented stream lifecycle; read the run or event-list operation instead.",
        "x-punaha-when-to-use": "Use this while monitoring a run when a streamed terminal or waiting-state update is more appropriate than repeated polling."
      }
    },
    "/api/workflows/{workflowId}/runs/{runId}/human-tasks/{nodeId}/complete": {
      "post": {
        "description": "### Purpose\nComplete workflows. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this when the documented business action or resource creation is the intended next step.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiWorkflowsWorkflowIdRunsRunIdHumanTasksNodeIdComplete",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The node id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "nodeId",
            "required": true,
            "schema": {
              "description": "The node id that identifies the resource selected by this operation.",
              "example": "example-nodeid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The run id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "runId",
            "required": true,
            "schema": {
              "description": "The run id that identifies the resource selected by this operation.",
              "example": "example-runid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "complete": {
                  "summary": "Complete representative request using synthetic data",
                  "value": {
                    "output": "example-value"
                  }
                },
                "smallestValid": {
                  "summary": "Smallest schema-valid request",
                  "value": {
                    "output": "example-value"
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "output": {
                    "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                    "example": "example-value",
                    "x-punaha-access": "Inherits the operation access rules.",
                    "x-punaha-arbitrary": true,
                    "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                    "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                    "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                    "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                    "x-punaha-lifecycle": {
                      "deprecated": false,
                      "since": "Next Product release"
                    },
                    "x-punaha-mutability": "Settable when this operation accepts the field; later changes depend on the resource operation.",
                    "x-punaha-presence": "required",
                    "x-punaha-sensitive": false,
                    "x-punaha-source": "Provided by the caller and validated by Pūnaha."
                  }
                },
                "required": [
                  "output"
                ],
                "type": "object"
              }
            }
          },
          "description": "Operation request. Every property documents omission, null, sensitivity, source, mutability, availability, access, and lifecycle semantics through JSON Schema and x-punaha-* annotations.",
          "required": true
        },
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  },
                  "tenant-context-required": {
                    "summary": "Select a tenant before using this endpoint.",
                    "value": {
                      "error": {
                        "code": "TENANT_CONTEXT_REQUIRED",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "Select a tenant before using this endpoint."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Complete workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "execute",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:600",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "workflow.human_task_completed"
          ],
          "backgroundBehaviour": "The operation may create, observe, or advance background work. Use the related read, event, or status operation before retrying after an uncertain outcome.",
          "backgroundWork": true,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "Select a tenant before using this endpoint.",
            "code": "TENANT_CONTEXT_REQUIRED",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": {
                "output": "example-value"
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs/example-runId/human-tasks/example-nodeId/complete"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": {
                "output": "example-value"
              },
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs/example-runId/human-tasks/example-nodeId/complete"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/workflows/example-workflowId/runs/example-runId/human-tasks/example-nodeId/complete"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Complete workflows. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this when the documented business action or resource creation is the intended next step."
      }
    },
    "/api/workflows/{workflowId}/star": {
      "delete": {
        "description": "### Purpose\nDelete workflows. This removes or retires the selected resource according to its lifecycle rules.\n\n### When to use it\nUse this only after checking dependencies and confirming that the selected resource should no longer be available.\n\n### When not to use it\nDo not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "operationId": "deleteapiWorkflowsWorkflowIdStar",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "delete",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:113",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "workflow.unstarred"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId/star"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId/star"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "DELETE",
              "path": "/api/workflows/example-workflowId/star"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Delete workflows. This removes or retires the selected resource according to its lifecycle rules.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnProfilesCommonExecutable",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this as a reversible disable action unless this operation explicitly documents that lifecycle behaviour; prefer the resource's update or transition operation when available.",
        "x-punaha-when-to-use": "Use this only after checking dependencies and confirming that the selected resource should no longer be available."
      },
      "put": {
        "description": "### Purpose\nStar workflows. This replaces or sets the selected state using the full supplied value.\n\n### When to use it\nUse this when the caller has read the current state and is authorised to change the documented fields or lifecycle state.\n\n### When not to use it\nDo not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "operationId": "putapiWorkflowsWorkflowIdStar",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The operation completed successfully and intentionally returns no body.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Star workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:100",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "workflow.starred"
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/star"
            },
            "response": {
              "status": "204"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/star"
            },
            "response": {
              "status": "204"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "PUT",
              "path": "/api/workflows/example-workflowId/star"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Star workflows. This replaces or sets the selected state using the full supplied value.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to create an unrelated resource or bypass a purpose-built transition, validation, or permission-check operation.",
        "x-punaha-when-to-use": "Use this when the caller has read the current state and is authorised to change the documented fields or lifecycle state."
      }
    },
    "/api/workflows/{workflowId}/validate": {
      "post": {
        "description": "### Purpose\nValidate workflows. This applies the validated business action to the selected tenant or platform resource.\n\n### When to use it\nUse this before the related state-changing action to confirm that the proposed configuration or resource is usable.\n\n### When not to use it\nDo not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "operationId": "postapiWorkflowsWorkflowIdValidate",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Validation or connectivity check completed; the response explains the current result.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "invalid-request-body": {
                    "summary": "The request body or supplied field values are invalid.",
                    "value": {
                      "error": {
                        "code": "INVALID_REQUEST_BODY",
                        "details": {
                          "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help."
                        },
                        "message": "The request body or supplied field values are invalid."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 400. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "examples": {
                  "state-conflict": {
                    "summary": "Current resource state or a dependency prevents the requested change.",
                    "value": {
                      "error": {
                        "code": "STATE_CONFLICT",
                        "details": {
                          "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request."
                        },
                        "message": "Current resource state or a dependency prevents the requested change."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 409. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Validate workflows",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.manage"
          ],
          "resourceAction": "update",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:367",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [
            "The mutation is subject to the Product audit policy; the exact event name is operation-owned and must be reviewed before publication."
          ],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Validates access and input, then applies the operation-specific state change. A failed validation or authorisation check does not intentionally apply the requested change.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The request body or supplied field values are invalid.",
            "code": "INVALID_REQUEST_BODY",
            "correction": "Correct the named field or rule in error.details, then submit a new request. Retrying an unchanged request will not help.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "400"
          },
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "Current resource state or a dependency prevents the requested change.",
            "code": "STATE_CONFLICT",
            "correction": "Read current state, resolve the named dependency or lifecycle conflict, and submit a deliberate new request.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "409"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "The caller must read current resource or background-operation state before retrying because work may have started before the failure became observable.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "POST",
              "path": "/api/workflows/example-workflowId/validate"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "POST",
              "path": "/api/workflows/example-workflowId/validate"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "POST",
              "path": "/api/workflows/example-workflowId/validate"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Validate workflows. This applies the validated business action to the selected tenant or platform resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": false,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "Do not retry automatically after a timeout or lost response; read current state first.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not repeat the request blindly after an uncertain outcome. Read the resulting resource or background-operation state first.",
        "x-punaha-when-to-use": "Use this before the related state-changing action to confirm that the proposed configuration or resource is usable."
      }
    },
    "/api/workflows/{workflowId}/versions": {
      "get": {
        "description": "### Purpose\nGet workflows versions. This reads the current tenant or platform state without changing the resource.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getapiWorkflowsWorkflowIdVersions",
        "parameters": [
          {
            "description": "Optional caller-supplied correlation identifier. Pūnaha returns the effective value in the response header.",
            "in": "header",
            "name": "x-request-id",
            "required": false,
            "schema": {
              "example": "example-request-001",
              "maxLength": 200,
              "minLength": 1,
              "type": "string",
              "x-punaha-empty": "Omit the header to let Pūnaha generate an identifier; do not send an empty value.",
              "x-punaha-presence": "optional",
              "x-punaha-sensitive": false
            }
          },
          {
            "description": "The workflow id that identifies the resource selected by this operation.",
            "in": "path",
            "name": "workflowId",
            "required": true,
            "schema": {
              "description": "The workflow id that identifies the resource selected by this operation.",
              "example": "example-workflowid",
              "minLength": 1,
              "type": "string",
              "x-punaha-access": "The identifier does not grant access; the selected resource is authorised independently.",
              "x-punaha-availability": "Inherits the operation availability.",
              "x-punaha-empty": "Empty path segments are not valid. URL-encode the identifier when required.",
              "x-punaha-lifecycle": {
                "deprecated": false,
                "since": "Next Product release"
              },
              "x-punaha-mutability": "Selects the existing resource for this operation.",
              "x-punaha-presence": "required",
              "x-punaha-sensitive": false,
              "x-punaha-source": "Obtained from the corresponding list, create, or lookup operation."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "data": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "description": "A JSON-compatible value returned by this operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "authentication-required": {
                    "summary": "A valid authenticated session or supported token is required.",
                    "value": {
                      "error": {
                        "code": "AUTHENTICATION_REQUIRED",
                        "details": {
                          "correction": "Authenticate again using a supported mechanism and confirm that the credential is current."
                        },
                        "message": "A valid authenticated session or supported token is required."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 401. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "402": {
            "content": {
              "application/json": {
                "examples": {
                  "feature-not-licensed": {
                    "summary": "The active licence does not include a required entitlement.",
                    "value": {
                      "error": {
                        "code": "FEATURE_NOT_LICENSED",
                        "details": {
                          "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence."
                        },
                        "message": "The active licence does not include a required entitlement."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 402. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "permission-required": {
                    "summary": "The authenticated actor does not have the exact permission or resource action.",
                    "value": {
                      "error": {
                        "code": "PERMISSION_REQUIRED",
                        "details": {
                          "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate."
                        },
                        "message": "The authenticated actor does not have the exact permission or resource action."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 403. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "not-found": {
                    "summary": "The selected resource does not exist in the authorised scope.",
                    "value": {
                      "error": {
                        "code": "NOT_FOUND",
                        "details": {
                          "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant."
                        },
                        "message": "The selected resource does not exist in the authorised scope."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 404. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "sessionCookie": []
          },
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get workflows versions",
        "tags": [
          "Workflows and runs"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Authenticated Pūnaha actor authorised for the selected tenant and resource"
          ],
          "audience": "customer-integration",
          "authentication": [
            "sessionCookie",
            "bearerAuth"
          ],
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [
            "workflows.read"
          ],
          "resourceAction": "view",
          "resourceScope": "example-workflowid",
          "resourceType": "workflow",
          "tenantRule": "Tenant-scoped unless the selected actor is performing an explicitly documented platform action. The x-organization-id header or authenticated session context selects the tenant; it does not grant access."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "workflow_inference.go:425",
          "owner": "Workflows and runs",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [
            "workflow.enabled"
          ],
          "featureState": "preview",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "workflow"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "A valid authenticated session or supported token is required.",
            "code": "AUTHENTICATION_REQUIRED",
            "correction": "Authenticate again using a supported mechanism and confirm that the credential is current.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "401"
          },
          {
            "cause": "The active licence does not include a required entitlement.",
            "code": "FEATURE_NOT_LICENSED",
            "correction": "Use an operation covered by the active entitlement or ask the System Owner to review the signed licence.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "402"
          },
          {
            "cause": "The authenticated actor does not have the exact permission or resource action.",
            "code": "PERMISSION_REQUIRED",
            "correction": "Select the correct tenant and resource, then ask an authorised administrator to grant the exact documented action if appropriate.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "403"
          },
          {
            "cause": "The selected resource does not exist in the authorised scope.",
            "code": "NOT_FOUND",
            "correction": "Obtain the identifier from the related list or create operation and confirm the selected tenant.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "404"
          },
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/api/workflows/example-workflowId/versions"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/api/workflows/example-workflowId/versions"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "permissionFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/api/workflows/example-workflowId/versions"
            },
            "response": {
              "body": {
                "error": {
                  "code": "PERMISSION_REQUIRED",
                  "details": {
                    "correction": "Request the documented access for the selected tenant resource."
                  },
                  "message": "The exact permission or resource action is required."
                }
              },
              "status": 403
            },
            "retryUnchanged": false,
            "story": "The caller is authenticated but lacks the exact tenant resource action. Select the correct tenant and obtain the documented permission before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "preview",
        "x-punaha-publication-status": "Preview",
        "x-punaha-purpose": "Get workflows versions. This reads the current tenant or platform state without changing the resource.",
        "x-punaha-related-operations": [
          {
            "operationId": "deleteapiWorkflowsWorkflowId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdRunsRunId",
            "relationship": "same-domain"
          },
          {
            "operationId": "deleteapiWorkflowsWorkflowIdStar",
            "relationship": "same-domain"
          },
          {
            "operationId": "getapiWorkflows",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformance",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getapiWorkflowsBpmnConformanceReport",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/health": {
      "get": {
        "description": "### Purpose\nReports the installation health state used by operators and automated probes.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getHealth",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "database": {
                        "domains": {},
                        "provider": "example-value"
                      },
                      "lancedb": {},
                      "licensing": "example-value",
                      "membership": "example-value",
                      "modelRuntime": "example-value",
                      "mysql": {},
                      "processing": {},
                      "service": "example-value",
                      "services": [
                        "example-value"
                      ],
                      "status": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "database": {
                      "additionalProperties": false,
                      "description": "The database associated with this resource or operation.",
                      "example": {},
                      "properties": {
                        "domains": {
                          "additionalProperties": true,
                          "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                          "example": {},
                          "type": "object",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-arbitrary": true,
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        },
                        "provider": {
                          "description": "The provider associated with this resource or operation.",
                          "example": "example-value",
                          "type": "string",
                          "x-punaha-access": "Inherits the operation access rules.",
                          "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                          "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                          "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                          "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                          "x-punaha-lifecycle": {
                            "deprecated": false,
                            "since": "Next Product release"
                          },
                          "x-punaha-mutability": "Read-only in this response representation.",
                          "x-punaha-presence": "required",
                          "x-punaha-sensitive": false,
                          "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                        }
                      },
                      "required": [
                        "domains",
                        "provider"
                      ],
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "lancedb": {
                      "additionalProperties": true,
                      "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                      "example": {},
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "licensing": {
                      "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "membership": {
                      "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "modelRuntime": {
                      "description": "A JSON value whose shape is explicitly determined by the selected configuration, provider, or operation.",
                      "example": "example-value",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "mysql": {
                      "additionalProperties": true,
                      "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                      "example": {},
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "processing": {
                      "additionalProperties": true,
                      "description": "Keys are defined by the selected configuration, provider, or resource type; values follow the documented field schema.",
                      "example": {},
                      "type": "object",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-arbitrary": true,
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "service": {
                      "description": "The service associated with this resource or operation.",
                      "example": "example-value",
                      "type": "string",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "services": {
                      "description": "The services associated with this resource or operation.",
                      "example": [
                        "example-value"
                      ],
                      "items": {
                        "example": "example-value",
                        "type": "string"
                      },
                      "type": "array",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "status": {
                      "description": "The current lifecycle or processing state.",
                      "example": "example-value",
                      "type": "string",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "database",
                    "lancedb",
                    "licensing",
                    "membership",
                    "modelRuntime",
                    "mysql",
                    "processing",
                    "service",
                    "services",
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [],
        "summary": "List health",
        "tags": [
          "Health and observability"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Unauthenticated caller for this bootstrap, authentication, or health operation"
          ],
          "audience": "customer-integration",
          "authentication": null,
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [],
          "resourceAction": "",
          "resourceScope": "",
          "resourceType": "",
          "tenantRule": "Installation-scoped; a tenant selector does not change this operation's authority boundary."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "server.go:948",
          "owner": "Platform operations",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "stable",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "all"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/health"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/health"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "validationFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/health"
            },
            "response": {
              "body": {
                "error": {
                  "code": "INVALID_REQUEST_BODY",
                  "details": {
                    "correction": "Supply the required schema-valid values."
                  },
                  "message": "The request body is invalid."
                }
              },
              "status": 400
            },
            "retryUnchanged": false,
            "story": "A required value is missing or invalid. Correct the request using the field constraints before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "stable",
        "x-punaha-publication-status": "Stable",
        "x-punaha-purpose": "Reports the installation health state used by operators and automated probes.",
        "x-punaha-related-operations": [
          {
            "operationId": "getHealthLive",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getHealthReady",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/health/live": {
      "get": {
        "description": "### Purpose\nReports the installation health state used by operators and automated probes.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getHealthLive",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "summary": "Successful response using synthetic data",
                    "value": {
                      "instanceId": "example-value",
                      "service": "example-value",
                      "status": "example-value"
                    }
                  }
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "instanceId": {
                      "description": "The instance id associated with this resource or operation.",
                      "example": "example-value",
                      "type": "string",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "service": {
                      "description": "The service associated with this resource or operation.",
                      "example": "example-value",
                      "type": "string",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    },
                    "status": {
                      "description": "The current lifecycle or processing state.",
                      "example": "example-value",
                      "type": "string",
                      "x-punaha-access": "Inherits the operation access rules.",
                      "x-punaha-availability": "Inherits the operation availability unless an operation-specific rule says otherwise.",
                      "x-punaha-default": "No client default is assumed unless a JSON Schema default is present.",
                      "x-punaha-empty": "The field is present. Empty strings or collections are valid only when the field constraints and operation rules allow them.",
                      "x-punaha-handling": "No special handling is inferred beyond normal tenant access, audit, retention, and data-classification controls.",
                      "x-punaha-lifecycle": {
                        "deprecated": false,
                        "since": "Next Product release"
                      },
                      "x-punaha-mutability": "Read-only in this response representation.",
                      "x-punaha-presence": "required",
                      "x-punaha-sensitive": false,
                      "x-punaha-source": "Returned from current Pūnaha state or computed by the operation."
                    }
                  },
                  "required": [
                    "instanceId",
                    "service",
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The operation completed and the response contains the current operation-specific representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [],
        "summary": "List health live",
        "tags": [
          "Health and observability"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Unauthenticated caller for this bootstrap, authentication, or health operation"
          ],
          "audience": "customer-integration",
          "authentication": null,
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [],
          "resourceAction": "",
          "resourceScope": "",
          "resourceType": "",
          "tenantRule": "Installation-scoped; a tenant selector does not change this operation's authority boundary."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "server.go:949",
          "owner": "Platform operations",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "stable",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "all"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/health/live"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/health/live"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "validationFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/health/live"
            },
            "response": {
              "body": {
                "error": {
                  "code": "INVALID_REQUEST_BODY",
                  "details": {
                    "correction": "Supply the required schema-valid values."
                  },
                  "message": "The request body is invalid."
                }
              },
              "status": 400
            },
            "retryUnchanged": false,
            "story": "A required value is missing or invalid. Correct the request using the field constraints before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "stable",
        "x-punaha-publication-status": "Stable",
        "x-punaha-purpose": "Reports the installation health state used by operators and automated probes.",
        "x-punaha-related-operations": [
          {
            "operationId": "getHealth",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getHealthReady",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    },
    "/health/ready": {
      "get": {
        "description": "### Purpose\nReports the installation health state used by operators and automated probes.\n\n### When to use it\nUse this when an integration needs the current representation before deciding its next action.\n\n### When not to use it\nDo not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "operationId": "getHealthReady",
        "parameters": [],
        "responses": {
          "200": {
            "description": "The GET operation completed successfully. This action does not expose a separately typed JSON representation.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "423": {
            "content": {
              "application/json": {
                "examples": {
                  "licence-remediation-required": {
                    "summary": "The installation is restricted and permits only licence-remediation actions.",
                    "value": {
                      "error": {
                        "code": "LICENCE_REMEDIATION_REQUIRED",
                        "details": {
                          "correction": "Complete the indicated licence or membership remediation before retrying Product work."
                        },
                        "message": "The installation is restricted and permits only licence-remediation actions."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 423. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "internal-error": {
                    "summary": "Pūnaha could not complete the operation because of an unexpected internal failure.",
                    "value": {
                      "error": {
                        "code": "INTERNAL_ERROR",
                        "details": {
                          "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR."
                        },
                        "message": "Pūnaha could not complete the operation because of an unexpected internal failure."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 500. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "examples": {
                  "dependency-unavailable": {
                    "summary": "A required node, database, provider, or service is temporarily unavailable.",
                    "value": {
                      "error": {
                        "code": "DEPENDENCY_UNAVAILABLE",
                        "details": {
                          "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe."
                        },
                        "message": "A required node, database, provider, or service is temporarily unavailable."
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/APIError"
                }
              }
            },
            "description": "The operation failed with HTTP 503. Inspect error.code and error.details, apply the documented correction, and retain x-request-id.",
            "headers": {
              "x-request-id": {
                "description": "Correlation identifier to include when diagnosing the request or raising a support case.",
                "required": true,
                "schema": {
                  "example": "example-request-001",
                  "minLength": 1,
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [],
        "summary": "List health ready",
        "tags": [
          "Health and observability"
        ],
        "x-punaha-access": {
          "actorRules": [
            "Unauthenticated caller for this bootstrap, authentication, or health operation"
          ],
          "audience": "customer-integration",
          "authentication": null,
          "explicitDeny": "An applicable explicit deny overrides an allow. Knowing or supplying a resource identifier never grants access.",
          "permissions": [],
          "resourceAction": "",
          "resourceScope": "",
          "resourceType": "",
          "tenantRule": "Installation-scoped; a tenant selector does not change this operation's authority boundary."
        },
        "x-punaha-audience": "customer-integration",
        "x-punaha-authoring": {
          "contractSource": "server.go:952",
          "owner": "Platform operations",
          "publicationApproved": false,
          "reviewRequired": true,
          "schemaSource": "Generated from current Go request and response types"
        },
        "x-punaha-availability": {
          "deploymentModes": [
            "customer-managed-installation"
          ],
          "entitlements": [],
          "featureState": "stable",
          "lastProductVersion": null,
          "licence": "An active Product licence is required except for health, authentication, and licence-remediation operations.",
          "minimumProductVersion": "Next Product release",
          "serviceRoles": [
            "all"
          ]
        },
        "x-punaha-behaviour": {
          "auditEvents": [],
          "backgroundBehaviour": "No background work is inferred; the success response represents completion of the HTTP action.",
          "backgroundWork": false,
          "changes": "Reads current state and does not intentionally change a Product resource.",
          "externalEffects": "No external call is inferred from the route name. Operation-specific service behaviour remains authoritative.",
          "transactionBoundary": "The HTTP success or error describes the synchronous boundary. Background operations have their own observable lifecycle and may outlive the request."
        },
        "x-punaha-errors": [
          {
            "cause": "The installation is restricted and permits only licence-remediation actions.",
            "code": "LICENCE_REMEDIATION_REQUIRED",
            "correction": "Complete the indicated licence or membership remediation before retrying Product work.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "423"
          },
          {
            "cause": "Pūnaha could not complete the operation because of an unexpected internal failure.",
            "code": "INTERNAL_ERROR",
            "correction": "Retain x-request-id and the stable error code, avoid blind retries, and investigate the operation or contact support. Code: INTERNAL_ERROR.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": false,
            "status": "500"
          },
          {
            "cause": "A required node, database, provider, or service is temporarily unavailable.",
            "code": "DEPENDENCY_UNAVAILABLE",
            "correction": "Retain x-request-id, check health and the named dependency, then retry with bounded backoff when safe.",
            "partialWork": "No requested mutation is expected before this failure boundary.",
            "retryable": true,
            "status": "503"
          }
        ],
        "x-punaha-examples": [
          {
            "name": "smallestValid",
            "request": {
              "body": null,
              "method": "GET",
              "path": "/health/ready"
            },
            "response": {
              "status": "200"
            },
            "story": "Send the smallest schema-valid request in the correct tenant and access context.",
            "syntheticData": true
          },
          {
            "name": "commonOptions",
            "request": {
              "body": null,
              "headers": {
                "x-request-id": "example-request-001"
              },
              "method": "GET",
              "path": "/health/ready"
            },
            "response": {
              "status": "200"
            },
            "story": "Use representative common options, then read or monitor the resulting resource before continuing the journey.",
            "syntheticData": true
          },
          {
            "name": "validationFailure",
            "partialWork": false,
            "request": {
              "method": "GET",
              "path": "/health/ready"
            },
            "response": {
              "body": {
                "error": {
                  "code": "INVALID_REQUEST_BODY",
                  "details": {
                    "correction": "Supply the required schema-valid values."
                  },
                  "message": "The request body is invalid."
                }
              },
              "status": 400
            },
            "retryUnchanged": false,
            "story": "A required value is missing or invalid. Correct the request using the field constraints before retrying.",
            "syntheticData": true
          }
        ],
        "x-punaha-lifecycle": "stable",
        "x-punaha-publication-status": "Stable",
        "x-punaha-purpose": "Reports the installation health state used by operators and automated probes.",
        "x-punaha-related-operations": [
          {
            "operationId": "getHealth",
            "relationship": "read-or-monitor"
          },
          {
            "operationId": "getHealthLive",
            "relationship": "read-or-monitor"
          }
        ],
        "x-punaha-reliability": {
          "concurrency": "Use documented If-Match or resource revision fields where exposed; otherwise read current state before changing it and handle HTTP 409 conflicts.",
          "consistency": "The response reflects the synchronous operation boundary. Background and provider-backed state can converge later and must be read through its status operation.",
          "idempotent": true,
          "requestIdentifier": "Send or record x-request-id and retain the returned value for diagnosis.",
          "retry": "A retry is normally safe only with the same resource, body, tenant, and concurrency preconditions; confirm the first outcome when external effects are possible.",
          "timeout": "Client timeouts do not cancel completed or already-started server work unless the operation explicitly supports cancellation."
        },
        "x-punaha-version-history": [
          {
            "change": "Operation documented from the current registered Go route and handler contract.",
            "deprecated": false,
            "version": "Next Product release"
          }
        ],
        "x-punaha-when-not-to-use": "Do not use this to infer access to another resource or tenant; use the matching access-check operation and an explicitly selected tenant context.",
        "x-punaha-when-to-use": "Use this when an integration needs the current representation before deciding its next action."
      }
    }
  },
  "servers": [
    {
      "description": "This Pūnaha installation",
      "url": "/"
    }
  ],
  "tags": [
    {
      "description": "Sign in, manage sessions and invitations, check permissions, and work with identity providers.",
      "name": "Access and identity",
      "summary": "Access and identity operations"
    },
    {
      "description": "Build, publish, and run workflows, complete human tasks, and monitor workflow events.",
      "name": "Workflows and runs",
      "summary": "Workflows and runs operations"
    },
    {
      "description": "Define case types and manage cases, plan items, files, and lifecycle work.",
      "name": "Cases and case types",
      "summary": "Cases and case types operations"
    },
    {
      "description": "Discover and configure models, run chat and embeddings, and work with model providers.",
      "name": "Models and inference",
      "summary": "Models and inference operations"
    },
    {
      "description": "Manage knowledge stores, documents, ingestion, extraction, and semantic search.",
      "name": "Knowledge and documents",
      "summary": "Knowledge and documents operations"
    },
    {
      "description": "Configure the connections and storage destinations used by workflows and integrations.",
      "name": "Connections and storage",
      "summary": "Connections and storage operations"
    },
    {
      "description": "Check service health, review audit activity, inspect logs, and investigate operational events.",
      "name": "Health and observability",
      "summary": "Health and observability operations"
    }
  ],
  "x-punaha-contract": {
    "apiCompatibilityVersion": "v1",
    "classificationCounts": {
      "Internal": 329,
      "Preview": 93,
      "Stable": 3
    },
    "enabledServiceRoles": [
      "core",
      "vector",
      "workflow",
      "inference",
      "frontend"
    ],
    "includedOperationCount": 96,
    "missingSourceAssociations": [],
    "openapiDialect": "3.2.0",
    "productVersion": "1.0.0",
    "publicationApproved": false,
    "publicationNote": "Local contract generation and review do not authorize public publication or establish Stable support commitments.",
    "registeredRouteCount": 425,
    "sourceDigest": "4996811773168fbc7d9436a805fb2382f309ffd4d66e58ae5233f721c09f54f5",
    "view": "customer"
  }
}
