{
  "openapi": "3.0.4",
  "info": {
    "title": "Namirial Sign Enterprise API",
    "description": "Namirial Sign Enterprise API",
    "contact": {
      "name": "Namirial Sign Enterprise API"
    },
    "version": "v1"
  },
  "paths": {
    "/api/v1/languages": {
      "get": {
        "tags": [
          "Application Reference Data"
        ],
        "summary": "List Application Languages",
        "description": "Returns the languages supported by the application. Use the `code` values returned here when setting the languages of an organization.",
        "operationId": "listLanguages",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LanguageListResponse"
                },
                "example": {
                  "languages": [
                    {
                      "code": "en",
                      "name": "English"
                    },
                    {
                      "code": "it",
                      "name": "Italian"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/countries": {
      "get": {
        "tags": [
          "Application Reference Data"
        ],
        "summary": "List countries",
        "description": "Returns the countries available for selection.",
        "operationId": "listCountries",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CountryListResponse"
                },
                "example": {
                  "countries": [
                    {
                      "code": "US",
                      "name": "United States"
                    },
                    {
                      "code": "IT",
                      "name": "Italy"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/timezones": {
      "get": {
        "tags": [
          "Application Reference Data"
        ],
        "summary": "List time zones",
        "description": "Returns the time zones available for selection.",
        "operationId": "listTimeZones",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeZoneListResponse"
                },
                "example": {
                  "timeZones": [
                    {
                      "code": "Europe/Berlin",
                      "name": "(UTC+01:00) Berlin"
                    },
                    {
                      "code": "Etc/UTC",
                      "name": "(UTC) Coordinated Universal Time"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/datetime-formats": {
      "get": {
        "tags": [
          "Application Reference Data"
        ],
        "summary": "List date-time formats",
        "description": "Returns the date-time formats available for selection.",
        "operationId": "listDateTimeFormats",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DateTimeFormatListResponse"
                },
                "example": {
                  "dateTimeFormats": [
                    {
                      "code": "dd/MM/yyyy | HH:mm"
                    },
                    {
                      "code": "yyyy-MM-dd | HH:mm"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes": {
      "get": {
        "tags": [
          "Bulk Envelope"
        ],
        "summary": "List bulk envelopes",
        "description": "Returns a paginated list of bulk envelope parents for the specified organization.",
        "operationId": "listBulkEnvelopes",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "UpdatedBefore",
            "in": "query",
            "description": "Filter bulk envelopes updated before this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "UpdatedAfter",
            "in": "query",
            "description": "Filter bulk envelopes updated after this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "SentBefore",
            "in": "query",
            "description": "Filter bulk envelopes sent before this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "SentAfter",
            "in": "query",
            "description": "Filter bulk envelopes sent after this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "SortingKey",
            "in": "query",
            "description": "The sorting key.",
            "schema": {
              "$ref": "#/components/schemas/BulkEnvelopeSortingKey"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Whether to sort in ascending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeListResponse"
                },
                "example": {
                  "bulkEnvelopes": [
                    {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Bulk contract for onboarding",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "sentAt": null
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 50,
                    "totalCount": 1
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Bulk Envelope"
        ],
        "summary": "Create bulk envelope",
        "description": "Creates a new bulk envelope parent in draft status within the specified organization.",
        "operationId": "createBulkEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBulkEnvelopeRequest"
              },
              "examples": {
                "PAdES, absolute expiration (default)": {
                  "value": {
                    "name": "Bulk contract for Q1 campaign",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:02.9913843+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": true,
                    "signatureReason": "Approved by Mario Rossi",
                    "afterSendRedirectUrl": "https://example.com/bulk-envelope-sent"
                  }
                },
                "PAdES, relative expiration": {
                  "value": {
                    "name": "Bulk contract for Q1 campaign",
                    "expiration": {
                      "mode": "Relative",
                      "afterSendInSeconds": 604800
                    },
                    "reminder": {
                      "enabled": false,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": false,
                    "signatureReason": "Approved by Mario Rossi"
                  }
                },
                "CAdES": {
                  "value": {
                    "name": "Bulk contract for Q1 campaign",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:02.9914574+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "signatureFormat": "Cades",
                    "afterSendRedirectUrl": "https://example.com/bulk-envelope-sent"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateBulkEnvelopeResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000001"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}": {
      "get": {
        "tags": [
          "Bulk Envelope"
        ],
        "summary": "Get bulk envelope",
        "description": "Returns a specific bulk envelope parent.",
        "operationId": "getBulkEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeResponse"
                },
                "examples": {
                  "PAdES, absolute expiration (default)": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Bulk contract for onboarding",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Absolute",
                        "expiresAt": "2026-12-11T14:00:02.9960751+00:00"
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "contract.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "sentAt": null,
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Pades",
                      "signatureReason": "Approved by Mario Rossi",
                      "statusChangeReason": "Document no longer required",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/bulk-envelope-sent"
                    }
                  },
                  "PAdES, relative expiration": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Bulk contract for onboarding",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Relative",
                        "afterSendInSeconds": 604800
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "contract.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "sentAt": null,
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Pades",
                      "signatureReason": "Approved by Mario Rossi",
                      "statusChangeReason": "Document no longer required",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/bulk-envelope-sent"
                    }
                  },
                  "CAdES": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Bulk contract for onboarding",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Absolute",
                        "expiresAt": "2026-12-11T14:00:02.9971942+00:00"
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "contract.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "sentAt": null,
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Cades",
                      "signatureReason": "Approved by Mario Rossi",
                      "statusChangeReason": "Document no longer required",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/bulk-envelope-sent"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Bulk Envelope"
        ],
        "summary": "Update bulk envelope",
        "description": "Updates a specific bulk envelope parent.",
        "operationId": "updateBulkEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBulkEnvelopeRequest"
              },
              "examples": {
                "PAdES, absolute expiration (default)": {
                  "value": {
                    "name": "Updated bulk contract name",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.0006848+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": true,
                    "signatureReason": "Approved by Mario Rossi",
                    "afterSendRedirectUrl": "https://example.com/bulk-envelope-sent"
                  }
                },
                "PAdES, relative expiration": {
                  "value": {
                    "name": "Updated bulk contract name",
                    "expiration": {
                      "mode": "Relative",
                      "afterSendInSeconds": 604800
                    },
                    "reminder": {
                      "enabled": false,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": false,
                    "signatureReason": "Approved by Mario Rossi",
                    "fileRestrictedVisibility": false
                  }
                },
                "CAdES": {
                  "value": {
                    "name": "Updated bulk contract name",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.0007414+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "signatureFormat": "Cades",
                    "afterSendRedirectUrl": "https://example.com/bulk-envelope-sent"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Bulk Envelope"
        ],
        "summary": "Delete bulk envelope",
        "description": "Deletes a specific bulk envelope parent and its related child envelopes.",
        "operationId": "deleteBulkEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/send": {
      "post": {
        "tags": [
          "Bulk Envelope Action"
        ],
        "summary": "Send bulk envelope",
        "description": "Sends the bulk envelope.",
        "operationId": "sendBulkEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/envelopes": {
      "get": {
        "tags": [
          "Bulk Envelope Detail"
        ],
        "summary": "List bulk envelope child envelopes",
        "description": "Returns a paginated list of the child envelopes generated by sending the specified bulk envelope.",
        "operationId": "listBulkEnvelopeChildEnvelopes",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Whether to sort in ascending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeChildEnvelopeListResponse"
                },
                "example": {
                  "envelopes": [
                    {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Contract for Mario Rossi",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "sentAt": null
                    },
                    {
                      "id": "00000000-0000-0000-0000-000000000002",
                      "name": "Contract for Anna Bianchi",
                      "status": "InProgress",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-02T12:00:00+00:00",
                      "sentAt": "2025-01-02T12:00:00+00:00"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 10,
                    "totalCount": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/files": {
      "get": {
        "tags": [
          "Bulk Envelope File"
        ],
        "summary": "List bulk-envelope files",
        "description": "Returns the files of the specified bulk-envelope.",
        "operationId": "listBulkEnvelopeFiles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeFileListResponse"
                },
                "example": {
                  "files": [
                    {
                      "id": "00000000-0000-0000-0000-000000000020",
                      "name": "contract.pdf",
                      "sortOrder": 1
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Bulk Envelope File"
        ],
        "summary": "Upload bulk-envelope file",
        "description": "Adds a new file to the specified bulk-envelope. The request body provides the file content (multipart/form-data) and, optionally, an initial document class assignment. Metadata values for the document class must be set afterwards via Update file properties.",
        "operationId": "uploadBulkEnvelopeFile",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "required": [
                  "file"
                ],
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  },
                  "documentClassId": {
                    "type": "string",
                    "format": "uuid",
                    "example": ""
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                },
                "documentClassId": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadBulkEnvelopeFileResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000020"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Bulk Envelope File"
        ],
        "summary": "Reorder bulk-envelope files",
        "description": "Reorders the files of the specified bulk-envelope.",
        "operationId": "reorderBulkEnvelopeFiles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchBulkEnvelopeFilesRequest"
              },
              "example": {
                "files": [
                  {
                    "id": "00000000-0000-0000-0000-000000000001",
                    "sortOrder": 1
                  },
                  {
                    "id": "00000000-0000-0000-0000-000000000002",
                    "sortOrder": 2
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/files/{fileId}": {
      "get": {
        "tags": [
          "Bulk Envelope File"
        ],
        "summary": "Get bulk-envelope file properties",
        "description": "Returns the properties of a specific bulk-envelope file, including the assigned document class and its metadata values. Does not include the file content.",
        "operationId": "getBulkEnvelopeFileDetail",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeFileDetailResponse"
                },
                "example": {
                  "documentClass": {
                    "id": "96b3bcea-384e-46f4-af32-d66ea7b42d10",
                    "name": "Contract",
                    "metadata": [
                      {
                        "type": "NumberType",
                        "value": 100.9,
                        "id": "c51ce27a-7a7b-4bbf-9f97-9fec418b5fa4",
                        "name": "Amount"
                      },
                      {
                        "type": "StringType",
                        "value": "New contract",
                        "id": "dd96ba7b-a489-4fd5-9d4b-3fed71ec127e",
                        "name": "Title"
                      },
                      {
                        "type": "DateType",
                        "value": "2026-05-20",
                        "id": "a04c0137-e059-4c22-b3df-9577293a5b69",
                        "name": "SignDate"
                      },
                      {
                        "type": "ListOptionType",
                        "value": "4ea6337b-84d6-4506-b3cb-7b9171f9fb92",
                        "id": "77d0be26-a5fe-4d62-95a1-008e6eeb7561",
                        "name": "ContractType"
                      }
                    ]
                  },
                  "restrictedVisibilityRecipientIds": [
                    "74393109-8a08-41ae-b1d3-203a7b06f544",
                    "a5bbd7ef-761e-48e8-86dc-0683275c12ac"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Bulk Envelope File"
        ],
        "summary": "Update bulk-envelope file properties",
        "description": "Updates the properties of a specific bulk-envelope file. Currently supports assigning a document class with metadata values. Does not modify the file content.",
        "operationId": "updateBulkEnvelopeFileDetail",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBulkEnvelopeFileDetailRequest"
              },
              "example": {
                "documentClass": {
                  "id": "6edd889f-1955-49d4-8f2d-23b729ef14e1",
                  "metadata": [
                    {
                      "type": "NumberType",
                      "value": 100.9,
                      "id": "c8189359-9755-4a5f-8640-abddd3591c70"
                    },
                    {
                      "type": "StringType",
                      "value": "New contract",
                      "id": "3a59b351-a19a-458c-9c55-51e0bf9f3ca6"
                    },
                    {
                      "type": "DateType",
                      "value": "2026-05-20",
                      "id": "6ddbb3c2-ee23-4763-849c-77c68c225eae"
                    },
                    {
                      "type": "ListOptionType",
                      "value": "9e63b394-d0a6-4beb-9c2e-36d77f24abd1",
                      "id": "d0236540-796a-4a00-8b29-f234fee4cd75"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Bulk Envelope File"
        ],
        "summary": "Delete bulk-envelope file",
        "description": "Deletes a specific file from the specified bulk-envelope.",
        "operationId": "deleteBulkEnvelopeFile",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/files/{fileId}/tasks": {
      "get": {
        "tags": [
          "Bulk Envelope File Task"
        ],
        "summary": "List bulk-envelope file tasks",
        "description": "Returns the tasks of a specific bulk-envelope file.",
        "operationId": "listBulkEnvelopeFileTasks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeFieldTaskListResponse"
                },
                "example": {
                  "tasks": [
                    {
                      "field": {
                        "fieldType": "Signature",
                        "allowedSignatureTypes": [
                          {
                            "signatureType": "ClickToSignSignature"
                          }
                        ],
                        "qualifiedTimeStamp": true,
                        "required": false,
                        "batchGroup": null,
                        "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                        "positionX": 100,
                        "positionY": 200,
                        "width": 200,
                        "height": 50,
                        "page": 1,
                        "id": "sig1"
                      },
                      "recipientId": "00000000-0000-0000-0000-000000000001",
                      "stageId": null,
                      "sortOrder": 1,
                      "source": "UserDefined"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Bulk Envelope File Task"
        ],
        "summary": "Update bulk-envelope file tasks",
        "description": "Replaces the tasks of a specific bulk-envelope file.",
        "operationId": "updateBulkEnvelopeFileTasks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBulkEnvelopeFileTasksRequest"
              },
              "examples": {
                "Signature - ClickToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "ClickToSignSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - DrawToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DrawToSignSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - TypeToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "TypeToSignSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - LocalCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "LocalCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - DisposableCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DisposableCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - Biometric": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "BiometricSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - RemoteCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "RemoteCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - OneTimePassword": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "OneTimePasswordSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - Plugin": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "PluginSignature",
                              "pluginId": "ArubaGsp"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - AutomaticSignature": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "AutomaticSignature"
                            }
                          ],
                          "required": true,
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - LocalCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "LocalCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - DisposableCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DisposableCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - RemoteCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "RemoteCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - Plugin": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "PluginSignature",
                              "pluginId": "ArubaGsp"
                            }
                          ],
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - String": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "StringType",
                            "value": "Default text",
                            "password": false,
                            "multiline": false,
                            "maxLength": 100
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Date": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "DateType",
                            "value": "2025-12-31",
                            "format": "dd.MM.yyyy",
                            "minValue": "2025-01-01",
                            "maxValue": "2026-12-31"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Number": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "NumberType",
                            "value": 42.51,
                            "thousandsSeparator": "Point",
                            "decimalSeparator": "Comma",
                            "symbol": {
                              "value": "€",
                              "position": "Start"
                            },
                            "decimalPlaces": 2,
                            "minValue": 10.25,
                            "maxValue": 1000.78
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - PhoneNumber": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "PhoneNumberType",
                            "value": "+393331234567",
                            "format": "InternationalLeadingPlus"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Time": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "TimeType",
                            "value": "14:30:00",
                            "format": "HH:mm",
                            "minValue": "08:00:00",
                            "maxValue": "18:00:00"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Checkbox": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Checkbox",
                          "checked": true,
                          "value": "yes",
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 300,
                          "width": 20,
                          "height": 20,
                          "page": 1,
                          "id": "chk1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "RadioButton": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "RadioButton",
                          "groupName": "group1",
                          "checked": false,
                          "readOnly": false,
                          "value": "option1",
                          "required": false,
                          "positionX": 100,
                          "positionY": 200,
                          "width": 20,
                          "height": 20,
                          "page": 1,
                          "id": "rb1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "DropDown": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "DropDown",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "options": [
                            {
                              "key": "val1",
                              "value": "Label 1",
                              "selected": false
                            },
                            {
                              "key": "val2",
                              "value": "Label 2",
                              "selected": true
                            }
                          ],
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 400,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "dd1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "ListBox": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "ListBox",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "options": [
                            {
                              "key": "val1",
                              "value": "Label 1",
                              "selected": false
                            },
                            {
                              "key": "val2",
                              "value": "Label 2",
                              "selected": true
                            }
                          ],
                          "multiselect": true,
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 500,
                          "width": 150,
                          "height": 80,
                          "page": 1,
                          "id": "lb1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Attachment": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Attachment",
                          "required": false,
                          "positionX": 50,
                          "positionY": 600,
                          "width": 100,
                          "height": 30,
                          "page": 1,
                          "id": "att1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Text": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Text",
                            "value": "Default text"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Date": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Date",
                            "format": "dd.MM.yyyy"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - FullName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "FullName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - FirstName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "FirstName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - LastName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "LastName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Initials": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Initials"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Email": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Email"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Link": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Link",
                          "reference": "https://example.com",
                          "positionX": 50,
                          "positionY": 700,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "lnk1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "FileReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "FileReadConfirmation",
                          "required": false,
                          "id": "frc1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "PageReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "PageReadConfirmation",
                          "required": false,
                          "page": 1,
                          "id": "prc1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "AreaReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "AreaReadConfirmation",
                          "required": false,
                          "positionX": 50,
                          "positionY": 250,
                          "width": 200,
                          "height": 100,
                          "page": 1,
                          "id": "arc1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Approval": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Approval",
                          "required": false,
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "app1"
                        },
                        "recipientId": null,
                        "stageId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/stages": {
      "get": {
        "tags": [
          "Bulk Envelope Stage"
        ],
        "summary": "List bulk envelope stages",
        "description": "Returns the stages of the specified bulk envelope.",
        "operationId": "listBulkEnvelopeStages",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeStageListResponse"
                },
                "example": {
                  "stages": [
                    {
                      "id": "00000000-0000-0000-0000-000000000010",
                      "name": "Stage 1",
                      "sortOrder": 1,
                      "requiredRecipientCompletions": 1,
                      "type": "Signer",
                      "mode": "Bulk"
                    },
                    {
                      "id": "00000000-0000-0000-0000-000000000011",
                      "name": "Stage 2",
                      "sortOrder": 2,
                      "requiredRecipientCompletions": 1,
                      "type": "Signer",
                      "mode": "Standard"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Bulk Envelope Stage"
        ],
        "summary": "Create bulk envelope stage",
        "description": "Creates a new stage for the specified bulk envelope.",
        "operationId": "createBulkEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBulkEnvelopeStageRequest"
              },
              "examples": {
                "Signer": {
                  "value": {
                    "type": "Signer",
                    "mode": "Standard",
                    "name": "Signer Stage",
                    "requiredRecipientCompletions": 1
                  }
                },
                "CarbonCopy": {
                  "value": {
                    "type": "CarbonCopy",
                    "mode": "Standard",
                    "name": "CarbonCopy Stage"
                  }
                },
                "Viewer": {
                  "value": {
                    "type": "Viewer",
                    "mode": "Standard",
                    "name": "Viewer Stage",
                    "requiredRecipientCompletions": 1
                  }
                },
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "mode": "Standard",
                    "name": "Automatic Stage"
                  }
                },
                "Approver": {
                  "value": {
                    "type": "Approver",
                    "mode": "Standard",
                    "name": "Approver Stage",
                    "requiredRecipientCompletions": 1
                  }
                },
                "Bulk Signer": {
                  "value": {
                    "type": "Signer",
                    "mode": "Bulk",
                    "name": "Bulk Stage"
                  }
                },
                "Bulk Approver": {
                  "value": {
                    "type": "Approver",
                    "mode": "Bulk",
                    "name": "Bulk Stage"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateBulkEnvelopeStageResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000010"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Bulk Envelope Stage"
        ],
        "summary": "Reorder bulk envelope stages",
        "description": "Reorders the stages of the specified bulk envelope.",
        "operationId": "reorderBulkEnvelopeStages",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchBulkEnvelopeStagesRequest"
              },
              "example": {
                "stages": [
                  {
                    "id": "00000000-0000-0000-0000-000000000001",
                    "sortOrder": 1
                  },
                  {
                    "id": "00000000-0000-0000-0000-000000000002",
                    "sortOrder": 2
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/stages/{stageId}": {
      "get": {
        "tags": [
          "Bulk Envelope Stage"
        ],
        "summary": "Get bulk envelope stage",
        "description": "Returns a specific bulk envelope stage.",
        "operationId": "getBulkEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeStageResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000010",
                  "name": "Stage 1",
                  "sortOrder": 1,
                  "requiredRecipientCompletions": 1,
                  "type": "Signer",
                  "mode": "Bulk",
                  "recipients": [
                    {
                      "type": "Standard",
                      "givenName": "Mario",
                      "surname": "Rossi",
                      "email": "mario.rossi@example.com",
                      "phoneNumber": "+39123456789",
                      "notificationChannels": [
                        "Email"
                      ],
                      "id": "00000000-0000-0000-0000-000000000100"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Bulk Envelope Stage"
        ],
        "summary": "Update bulk envelope stage",
        "description": "Updates a specific bulk envelope stage.",
        "operationId": "updateBulkEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBulkEnvelopeStageRequest"
              },
              "examples": {
                "Signer": {
                  "value": {
                    "name": "Signer Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Signer"
                  }
                },
                "CarbonCopy": {
                  "value": {
                    "name": "CarbonCopy Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "CarbonCopy"
                  }
                },
                "Viewer": {
                  "value": {
                    "name": "Viewer Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Viewer"
                  }
                },
                "Automatic": {
                  "value": {
                    "name": "Automatic Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Automatic"
                  }
                },
                "Approver": {
                  "value": {
                    "name": "Approver Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Approver"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Bulk Envelope Stage"
        ],
        "summary": "Delete bulk envelope stage",
        "description": "Deletes a specific bulk envelope stage.",
        "operationId": "deleteBulkEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/stages/{stageId}/recipients": {
      "post": {
        "tags": [
          "Bulk Envelope Stage Recipient"
        ],
        "summary": "Create bulk envelope stage recipient",
        "description": "Creates a new recipient for the specified bulk envelope stage. Standard-mode stages accept both Standard and Automatic recipients; Bulk-mode stages accept Standard recipients only and reject Automatic recipients with 422.",
        "operationId": "createBulkEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/CreateBulkEnvelopeStageAutomaticRecipientRequest"
                  },
                  {
                    "$ref": "#/components/schemas/CreateBulkEnvelopeStageStandardRecipientRequest"
                  }
                ],
                "description": "Base record for create bulk envelope stage recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
              },
              "examples": {
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "signatureProfile": "default-eseal-profile",
                    "signatureReason": "I agree to the terms.",
                    "languageCode": "en"
                  }
                },
                "Standard - No authentication": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OTP SMS": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oneTimePassword": {
                        "channel": "Sms"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Access code": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "accessCode": {
                        "code": "1234"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OAuth": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oAuthAuthentications": [
                        {
                          "providerName": "google",
                          "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                        }
                      ]
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Disposable certificate": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "signatureConfiguration": {
                      "disposableCertificate": {
                        "document": {
                          "type": "IdentityCard",
                          "number": "AA1234567",
                          "serialNumber": "SN-0001",
                          "issuingCountry": "IT",
                          "issuedBy": "Comune di Roma",
                          "issuedOn": "2020-01-15T00:00:00+00:00",
                          "expiresAt": "2030-01-15T00:00:00+00:00"
                        },
                        "identification": {
                          "type": "NationalIdentityCard",
                          "issuingCountry": "IT"
                        },
                        "verificationPhoneNumber": "+39123456789"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateBulkEnvelopeStageRecipientResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000100"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/stages/{stageId}/recipients/{recipientId}": {
      "get": {
        "tags": [
          "Bulk Envelope Stage Recipient"
        ],
        "summary": "Get bulk envelope stage recipient",
        "description": "Returns a specific bulk envelope stage recipient.",
        "operationId": "getBulkEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkEnvelopeStageRecipientResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000100",
                  "languageCode": "en",
                  "givenName": "Mario",
                  "surname": "Rossi",
                  "email": "mario.rossi@example.com",
                  "phoneNumber": "+39123456789",
                  "notificationChannels": [
                    "Email"
                  ],
                  "authentication": null,
                  "signatureConfiguration": null,
                  "personalMessage": "Please review and sign the attached contract.",
                  "metadata": null,
                  "signatureReason": "I agree to the terms.",
                  "isSignatureReasonEditable": false
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Bulk Envelope Stage Recipient"
        ],
        "summary": "Update bulk envelope stage recipient",
        "description": "Updates a specific bulk envelope stage recipient. Standard-mode stages accept both Standard and Automatic recipients; Bulk-mode stages accept Standard recipients only and reject Automatic recipients with 422.",
        "operationId": "updateBulkEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/UpdateBulkEnvelopeStageAutomaticRecipientRequest"
                  },
                  {
                    "$ref": "#/components/schemas/UpdateBulkEnvelopeStageStandardRecipientRequest"
                  }
                ],
                "description": "Base record for update bulk envelope stage recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
              },
              "examples": {
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "signatureProfile": "default-eseal-profile",
                    "signatureReason": "I agree to the terms.",
                    "languageCode": "en"
                  }
                },
                "Standard - No authentication": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OTP SMS": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oneTimePassword": {
                        "channel": "Sms"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Access code": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "accessCode": {
                        "code": "1234"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OAuth": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oAuthAuthentications": [
                        {
                          "providerName": "google",
                          "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                        }
                      ]
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Disposable certificate": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "signatureConfiguration": {
                      "disposableCertificate": {
                        "document": {
                          "type": "IdentityCard",
                          "number": "AA1234567",
                          "serialNumber": "SN-0001",
                          "issuingCountry": "IT",
                          "issuedBy": "Comune di Roma",
                          "issuedOn": "2020-01-15T00:00:00+00:00",
                          "expiresAt": "2030-01-15T00:00:00+00:00"
                        },
                        "identification": {
                          "type": "NationalIdentityCard",
                          "issuingCountry": "IT"
                        },
                        "verificationPhoneNumber": "+39123456789"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Bulk Envelope Stage Recipient"
        ],
        "summary": "Delete bulk envelope stage recipient",
        "description": "Deletes a specific bulk envelope stage recipient.",
        "operationId": "deleteBulkEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "bulkEnvelopeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/document-classes": {
      "get": {
        "tags": [
          "Document Class"
        ],
        "summary": "List document classes",
        "description": "Returns a paginated list of document classes for the specified organization.",
        "operationId": "listDocumentClasses",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentClassListResponse"
                },
                "example": {
                  "documentClasses": [
                    {
                      "id": "a975adef-8c62-4aec-9f0e-e3a428de04f8",
                      "name": "Contract"
                    },
                    {
                      "id": "42131078-1d69-4a15-9d40-0acbe72ca0d4",
                      "name": "Invoice"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 10,
                    "totalCount": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Document Class"
        ],
        "summary": "Create document class",
        "description": "Creates a new document class with the specified name, optional description, and metadata references. Metadata definitions are managed through the document metadata endpoints.",
        "operationId": "createDocumentClass",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDocumentClassRequest"
              },
              "example": {
                "name": "Contracts",
                "description": "Document class for contracts",
                "metadata": [
                  {
                    "id": "d4d97f11-d33d-4352-b75f-19015e186949",
                    "sortOrder": 1,
                    "required": true
                  },
                  {
                    "id": "8b190436-0990-48b6-ae15-54ff6caddddf",
                    "sortOrder": 2,
                    "required": true
                  },
                  {
                    "id": "ad48c6bc-de30-44e1-a32d-6e31332e96d0",
                    "sortOrder": 3,
                    "required": false
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateDocumentClassResponse"
                },
                "example": {
                  "id": "e40d5ec9-0689-4648-bf15-8332d937fa9b"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/document-classes/{documentClassId}": {
      "get": {
        "tags": [
          "Document Class"
        ],
        "summary": "Get document class",
        "description": "Returns the name, description, and full metadata field data of the specified document class.",
        "operationId": "getDocumentClass",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "documentClassId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentClassResponse"
                },
                "example": {
                  "id": "3937bfba-3090-49e4-951c-e7af9ef40812",
                  "name": "Contract",
                  "description": "Standard contract document class",
                  "metadata": [
                    {
                      "type": "StringType",
                      "id": "50ffb395-4f60-4f34-ad47-8d862bcf363d",
                      "name": "SignerName",
                      "required": true,
                      "sortOrder": 1
                    },
                    {
                      "type": "DateType",
                      "id": "7bb0a649-6256-4e22-98b7-eeed896f8288",
                      "name": "SignatureDate",
                      "required": false,
                      "sortOrder": 2
                    },
                    {
                      "type": "NumberType",
                      "id": "69d32878-2972-4ee5-9aad-4672f37290f0",
                      "name": "TotalAmount",
                      "required": true,
                      "sortOrder": 3
                    },
                    {
                      "type": "ListOptionType",
                      "options": [
                        {
                          "id": "ccdfeacd-954d-4d8d-98dd-43693b87864a",
                          "value": "Invoice",
                          "parentId": null
                        },
                        {
                          "id": "0bdde37c-a06d-4881-a1d7-99194abc3364",
                          "value": "NDA",
                          "parentId": null
                        }
                      ],
                      "parentId": null,
                      "id": "87601520-f6be-48c8-b7a8-6bd8839fafd0",
                      "name": "ContractType",
                      "required": true,
                      "sortOrder": 4
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Document Class"
        ],
        "summary": "Update document class",
        "description": "Updates the name, description, and metadata references of the specified document class. Metadata definitions are managed through the document metadata endpoints.",
        "operationId": "updateDocumentClass",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "documentClassId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDocumentClassRequest"
              },
              "example": {
                "name": "Contracts",
                "description": "Document class for contracts",
                "metadata": [
                  {
                    "id": "ba12e5d5-50dc-48c3-afe0-af5a1af6ef6e",
                    "sortOrder": 1,
                    "required": true
                  },
                  {
                    "id": "63d62ca1-0588-4de0-a465-6c623c0f1462",
                    "sortOrder": 2,
                    "required": true
                  },
                  {
                    "id": "e6ed43b9-8cc4-454c-85d7-2668b5856dbe",
                    "sortOrder": 3,
                    "required": false
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Document Class"
        ],
        "summary": "Delete document class",
        "description": "Deletes the specified document class.",
        "operationId": "deleteDocumentClass",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "documentClassId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/document-metadata": {
      "get": {
        "tags": [
          "Document Metadata"
        ],
        "summary": "List document metadata",
        "description": "Returns a paginated list of document metadata fields for the specified organization.",
        "operationId": "listDocumentMetadata",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "example": 1
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "example": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentMetadataListResult"
                },
                "example": {
                  "documentMetadata": [
                    {
                      "type": "StringType",
                      "id": "6b6014ef-9578-4478-8530-edd533a12556",
                      "name": "ContractNumber"
                    },
                    {
                      "type": "NumberType",
                      "id": "2a5dbed4-3478-436f-b231-1b413d5d2af9",
                      "name": "Amount"
                    },
                    {
                      "type": "DateType",
                      "id": "244e2c67-dca7-410f-8584-6abf53419afb",
                      "name": "SignatureDate"
                    },
                    {
                      "type": "ListOptionType",
                      "parentId": null,
                      "options": [
                        {
                          "id": "35dfedc0-e161-4ef9-adca-c8db0ae225d9",
                          "value": "Invoice",
                          "parentId": null
                        },
                        {
                          "id": "7c1f74f2-2632-4062-809a-3face031ea1d",
                          "value": "NDA",
                          "parentId": null
                        }
                      ],
                      "id": "a7c967ce-9246-4345-9ac5-376b30162c93",
                      "name": "ContractType"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 20,
                    "totalCount": 4
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Document Metadata"
        ],
        "summary": "Create document metadata",
        "description": "Creates a new document metadata field for the specified organization.",
        "operationId": "createDocumentMetadata",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/CreateStringDocumentMetadataRequest"
                  },
                  {
                    "$ref": "#/components/schemas/CreateNumberDocumentMetadataRequest"
                  },
                  {
                    "$ref": "#/components/schemas/CreateDateDocumentMetadataRequest"
                  },
                  {
                    "$ref": "#/components/schemas/CreateListOptionDocumentMetadataRequest"
                  }
                ],
                "description": "Request body for creating a document metadata field. Discriminated by the `type` property."
              },
              "examples": {
                "StringType": {
                  "value": {
                    "type": "StringType",
                    "name": "ContractNumber"
                  }
                },
                "NumberType": {
                  "value": {
                    "type": "NumberType",
                    "name": "TotalAmount"
                  }
                },
                "DateType": {
                  "value": {
                    "type": "DateType",
                    "name": "SignatureDate"
                  }
                },
                "ListOptionType": {
                  "value": {
                    "options": [
                      {
                        "value": "Invoice",
                        "parentId": "a3678500-66b3-494c-9eb2-4f8e302f819d"
                      },
                      {
                        "value": "NDA",
                        "parentId": "e69d376b-0cbf-4182-bc31-abe1ad284fbe"
                      }
                    ],
                    "parentId": "44d1e5d5-5747-42e5-ab4c-6be2e903cc1d",
                    "type": "ListOptionType",
                    "name": "ContractType"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/CreateStringDocumentMetadataResponse"
                    },
                    {
                      "$ref": "#/components/schemas/CreateNumberDocumentMetadataResponse"
                    },
                    {
                      "$ref": "#/components/schemas/CreateDateDocumentMetadataResponse"
                    },
                    {
                      "$ref": "#/components/schemas/CreateListOptionDocumentMetadataResponse"
                    }
                  ],
                  "description": "Response after creating a document metadata field. Discriminated by the `type` property."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/document-metadata/{metadataId}": {
      "get": {
        "tags": [
          "Document Metadata"
        ],
        "summary": "Get document metadata",
        "description": "Returns the specified document metadata field.",
        "operationId": "getDocumentMetadata",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "metadataId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/StringDocumentMetadataItem"
                    },
                    {
                      "$ref": "#/components/schemas/NumberDocumentMetadataItem"
                    },
                    {
                      "$ref": "#/components/schemas/DateDocumentMetadataItem"
                    },
                    {
                      "$ref": "#/components/schemas/ListOptionDocumentMetadataItem"
                    }
                  ],
                  "description": "Represents a document metadata field at the organization level. Discriminated by the `type` property."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Document Metadata"
        ],
        "summary": "Update document metadata",
        "description": "Updates the specified document metadata field.",
        "operationId": "updateDocumentMetadata",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "metadataId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/UpdateStringDocumentMetadataRequest"
                  },
                  {
                    "$ref": "#/components/schemas/UpdateNumberDocumentMetadataRequest"
                  },
                  {
                    "$ref": "#/components/schemas/UpdateDateDocumentMetadataRequest"
                  },
                  {
                    "$ref": "#/components/schemas/UpdateListOptionDocumentMetadataRequest"
                  }
                ],
                "description": "Request body for updating a document metadata field. Discriminated by the `type` property."
              },
              "examples": {
                "StringType": {
                  "value": {
                    "type": "StringType",
                    "name": "ContractNumber"
                  }
                },
                "NumberType": {
                  "value": {
                    "type": "NumberType",
                    "name": "TotalAmount"
                  }
                },
                "DateType": {
                  "value": {
                    "type": "DateType",
                    "name": "SignatureDate"
                  }
                },
                "ListOptionType": {
                  "value": {
                    "options": [
                      {
                        "value": "Invoice",
                        "parentId": "b5aeb01b-851a-4fe9-b21e-5100ed4f65ac"
                      },
                      {
                        "value": "NDA"
                      }
                    ],
                    "parentId": "f2e246a5-9dfa-464d-b9b1-3a809c2d7795",
                    "type": "ListOptionType",
                    "name": "ContractType"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Document Metadata"
        ],
        "summary": "Delete document metadata",
        "description": "Deletes the specified document metadata field.",
        "operationId": "deleteDocumentMetadata",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "metadataId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/document-metadata/{metadataId}/eligible-parents": {
      "get": {
        "tags": [
          "Document Metadata"
        ],
        "summary": "Get eligible parent metadata fields",
        "description": "Returns the list-option document metadata fields eligible to be set as the parent of the specified field (excludes the field itself and its own children, to avoid cyclic dependencies).",
        "operationId": "getDocumentMetadataEligibleParents",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "metadataId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EligibleParentsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes": {
      "get": {
        "tags": [
          "Envelope"
        ],
        "summary": "List envelopes",
        "description": "Returns a paginated list of envelopes for the specified organization.",
        "operationId": "listEnvelopes",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "UpdatedBefore",
            "in": "query",
            "description": "Filter envelopes updated before this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "UpdatedAfter",
            "in": "query",
            "description": "Filter envelopes updated after this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "SentBefore",
            "in": "query",
            "description": "Filter envelopes sent before this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "SentAfter",
            "in": "query",
            "description": "Filter envelopes sent after this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Status",
            "in": "query",
            "description": "Filter envelopes by status.",
            "schema": {
              "$ref": "#/components/schemas/EnvelopeStatusFilter"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "SortingKey",
            "in": "query",
            "description": "The sorting key.",
            "schema": {
              "$ref": "#/components/schemas/EnvelopeSortingKey"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Whether to sort in ascending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeListResponse"
                },
                "example": {
                  "envelopes": [
                    {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Contract for Mario Rossi",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "sentAt": null
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 50,
                    "totalCount": 1
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Envelope"
        ],
        "summary": "Create envelope",
        "description": "Creates a new envelope in draft status within the specified organization.",
        "operationId": "createEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEnvelopeRequest"
              },
              "examples": {
                "PAdES, absolute expiration (default)": {
                  "value": {
                    "name": "Contract for Mario Rossi",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.1763097+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": true,
                    "signatureReason": "Approved by Mario Rossi",
                    "afterSendRedirectUrl": "https://example.com/envelope-sent"
                  }
                },
                "PAdES, relative expiration": {
                  "value": {
                    "name": "Contract for Mario Rossi",
                    "expiration": {
                      "mode": "Relative",
                      "afterSendInSeconds": 604800
                    },
                    "reminder": {
                      "enabled": false,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": false,
                    "signatureReason": "Approved by Mario Rossi"
                  }
                },
                "CAdES": {
                  "value": {
                    "name": "Contract for Mario Rossi",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.1763703+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "signatureFormat": "Cades"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateEnvelopeResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000001"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}": {
      "get": {
        "tags": [
          "Envelope"
        ],
        "summary": "Get envelope",
        "description": "Returns a specific envelope.",
        "operationId": "getEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeResponse"
                },
                "examples": {
                  "PAdES, absolute expiration (default)": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Contract for Mario Rossi",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Absolute",
                        "expiresAt": "2026-12-11T14:00:03.1810163+00:00"
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "contract.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "sentAt": null,
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Pades",
                      "signatureReason": "Approved by Mario Rossi",
                      "statusChangeReason": "Document no longer required",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/envelope-sent",
                      "bulkEnvelopeId": null
                    }
                  },
                  "PAdES, relative expiration": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Contract for Mario Rossi",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Relative",
                        "afterSendInSeconds": 604800
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "contract.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "sentAt": null,
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Pades",
                      "signatureReason": "Approved by Mario Rossi",
                      "statusChangeReason": "Document no longer required",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/envelope-sent",
                      "bulkEnvelopeId": null
                    }
                  },
                  "CAdES": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Contract for Mario Rossi",
                      "status": "Draft",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Absolute",
                        "expiresAt": "2026-12-11T14:00:03.1810946+00:00"
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "contract.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "sentAt": null,
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Cades",
                      "signatureReason": "Approved by Mario Rossi",
                      "statusChangeReason": "Document no longer required",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/envelope-sent",
                      "bulkEnvelopeId": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Envelope"
        ],
        "summary": "Update envelope",
        "description": "Updates a specific envelope.",
        "operationId": "updateEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEnvelopeRequest"
              },
              "examples": {
                "PAdES, absolute expiration (default)": {
                  "value": {
                    "name": "Updated contract name",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.184352+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": true,
                    "signatureReason": "Approved by Mario Rossi",
                    "afterSendRedirectUrl": "https://example.com/envelope-sent"
                  }
                },
                "PAdES, relative expiration": {
                  "value": {
                    "name": "Updated contract name",
                    "expiration": {
                      "mode": "Relative",
                      "afterSendInSeconds": 604800
                    },
                    "reminder": {
                      "enabled": false,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": false,
                    "signatureReason": "Approved by Mario Rossi",
                    "fileRestrictedVisibility": false
                  }
                },
                "CAdES": {
                  "value": {
                    "name": "Updated contract name",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.1844105+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "signatureFormat": "Cades"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Envelope"
        ],
        "summary": "Delete envelope",
        "description": "Deletes a specific envelope.",
        "operationId": "deleteEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/send": {
      "post": {
        "tags": [
          "Envelope Action"
        ],
        "summary": "Send envelope",
        "description": "Sends the envelope.",
        "operationId": "sendEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/send-reminder": {
      "post": {
        "tags": [
          "Envelope Action"
        ],
        "summary": "Send envelope reminder",
        "description": "Sends a reminder notification to pending recipients.",
        "operationId": "sendEnvelopeReminder",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/resume": {
      "post": {
        "tags": [
          "Envelope Action"
        ],
        "summary": "Resume envelope",
        "description": "Resumes an envelope that was previously in an expired state.",
        "operationId": "resumeEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResumeEnvelopeRequest"
              },
              "example": {
                "newExpirationDate": "2026-11-18T14:00:03.1899635+00:00"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/cancel": {
      "post": {
        "tags": [
          "Envelope Action"
        ],
        "summary": "Cancel envelope",
        "description": "Cancels an in-progress envelope, stopping the signing workflow.",
        "operationId": "cancelEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelEnvelopeRequest"
              },
              "example": {
                "reason": "No longer needed"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/clone": {
      "post": {
        "tags": [
          "Envelope Action"
        ],
        "summary": "Clone envelope",
        "description": "Creates a new draft envelope by cloning an existing envelope.",
        "operationId": "cloneEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CloneEnvelopeResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000050"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/apply-policies": {
      "post": {
        "tags": [
          "Envelope Action"
        ],
        "summary": "Apply policies on envelope",
        "description": "Applies policies on an existing envelope.",
        "operationId": "applyPoliciesOnEnvelope",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/verify-policies": {
      "post": {
        "tags": [
          "Envelope Action"
        ],
        "summary": "Verify envelope policies",
        "description": "Checks whether the envelope satisfies all applicable document class policies without modifying its state.",
        "operationId": "verifyEnvelopePolicies",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerifyEnvelopePoliciesResponse"
                },
                "example": {
                  "compliant": true
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/events": {
      "get": {
        "tags": [
          "Envelope Detail"
        ],
        "summary": "List envelope events",
        "description": "Returns the events of the specified envelope.",
        "operationId": "listEnvelopeEvents",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeEventListResponse"
                },
                "example": {
                  "events": [
                    {
                      "id": "00000000-0000-0000-0000-000000000040",
                      "type": "EnvelopeSent",
                      "actor": {
                        "email": "owner@example.com"
                      },
                      "occurredAt": "2025-01-02T12:00:00+00:00"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/next-recipient-links": {
      "get": {
        "tags": [
          "Envelope Detail"
        ],
        "summary": "List next recipient links",
        "description": "Returns the next recipients in the signing workflow with their action links.",
        "operationId": "listNextRecipientLinks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NextRecipientLinksResponse"
                },
                "example": {
                  "nextRecipientLinks": [
                    {
                      "recipient": {
                        "id": "00000000-0000-0000-0000-000000000100",
                        "givenName": "Mario",
                        "surname": "Rossi",
                        "type": "Signer"
                      },
                      "link": "https://sign.example.com/recipient/00000000-0000-0000-0000-000000000100"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts": {
      "get": {
        "tags": [
          "Envelope Detail"
        ],
        "summary": "List envelope artifacts",
        "description": "Returns the artifacts of the specified envelope.",
        "operationId": "listEnvelopeArtifacts",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeArtifactListResponse"
                },
                "example": {
                  "artifacts": [
                    {
                      "id": "00000000-0000-0000-0000-000000000030",
                      "name": "contract-signed.pdf",
                      "type": "CompletedFile"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts/{artifactId}": {
      "get": {
        "tags": [
          "Envelope Detail"
        ],
        "summary": "Get envelope artifact",
        "description": "Returns a specific envelope artifact.",
        "operationId": "getEnvelopeArtifact",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/artifactId"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns the binary content of the file.",
            "headers": {
              "Content-Disposition": {
                "description": "Suggested filename for the downloaded file.",
                "schema": {
                  "type": "string",
                  "example": "attachment; filename=\"file\""
                }
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files": {
      "get": {
        "tags": [
          "Envelope File"
        ],
        "summary": "List envelope files",
        "description": "Returns the files of the specified envelope.",
        "operationId": "listEnvelopeFiles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeFileListResponse"
                },
                "example": {
                  "files": [
                    {
                      "id": "00000000-0000-0000-0000-000000000020",
                      "name": "contract.pdf",
                      "sortOrder": 1
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Envelope File"
        ],
        "summary": "Upload envelope file",
        "description": "Adds a new file to the specified envelope. The request body provides the file content (multipart/form-data) and, optionally, an initial document class assignment. Metadata values for the document class must be set afterwards via Update file properties.",
        "operationId": "uploadEnvelopeFile",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "required": [
                  "file"
                ],
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  },
                  "documentClassId": {
                    "type": "string",
                    "format": "uuid",
                    "example": ""
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                },
                "documentClassId": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadEnvelopeFileResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000020"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Envelope File"
        ],
        "summary": "Reorder envelope files",
        "description": "Reorders the files of the specified envelope.",
        "operationId": "reorderEnvelopeFiles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchEnvelopeFilesRequest"
              },
              "example": {
                "files": [
                  {
                    "id": "00000000-0000-0000-0000-000000000001",
                    "sortOrder": 1
                  },
                  {
                    "id": "00000000-0000-0000-0000-000000000002",
                    "sortOrder": 2
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}": {
      "get": {
        "tags": [
          "Envelope File"
        ],
        "summary": "Get file properties",
        "description": "Returns the properties of a specific envelope file, including the assigned document class and its metadata values. Does not include the file content.",
        "operationId": "getEnvelopeFileDetail",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeFileDetailResponse"
                },
                "example": {
                  "documentClass": {
                    "id": "3982311f-cec1-42b8-8799-6c304aa098ea",
                    "name": "Contract",
                    "metadata": [
                      {
                        "type": "NumberType",
                        "value": 100.9,
                        "id": "7c1a1484-2325-410e-ad03-a04470f721f5",
                        "name": "Amount"
                      },
                      {
                        "type": "StringType",
                        "value": "New contract",
                        "id": "449d3fea-8ea2-451f-8f6e-85433d6892a1",
                        "name": "Title"
                      },
                      {
                        "type": "DateType",
                        "value": "2026-05-20",
                        "id": "68142184-b184-4ca1-9edf-2a8a745e56ad",
                        "name": "SignDate"
                      },
                      {
                        "type": "ListOptionType",
                        "value": "d0e130ea-0531-4b9b-a3ba-e3ae1d2cee14",
                        "id": "723e64c6-5c5a-4d8a-aefa-95be4c897c0b",
                        "name": "ContractType"
                      }
                    ]
                  },
                  "restrictedVisibilityRecipientIds": [
                    "9cb9ee46-7932-440f-987f-3bf9e8174699",
                    "bfb6d84c-50fd-4b9a-a17a-a6b7fcbcce47"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Envelope File"
        ],
        "summary": "Update file properties",
        "description": "Updates the properties of a specific envelope file. Currently supports assigning a document class with metadata values. Does not modify the file content.",
        "operationId": "updateEnvelopeFileDetail",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEnvelopeFileDetailRequest"
              },
              "example": {
                "documentClass": {
                  "id": "84a8b8bc-cfa7-4969-ad4d-8144b6fdcc16",
                  "metadata": [
                    {
                      "type": "NumberType",
                      "value": 100.9,
                      "id": "d0b19ac7-9764-4993-8161-095f7209b392"
                    },
                    {
                      "type": "StringType",
                      "value": "New contract",
                      "id": "3180df92-f91b-4386-b485-788724b42e1f"
                    },
                    {
                      "type": "DateType",
                      "value": "2026-05-20",
                      "id": "b6bd937a-292d-4083-968e-a43ca25f94f8"
                    },
                    {
                      "type": "ListOptionType",
                      "value": "bb477fc0-9584-413b-bcf8-f5b7d456f260",
                      "id": "46d934f3-352e-42c0-b349-d30a47c59930"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Envelope File"
        ],
        "summary": "Delete envelope file",
        "description": "Deletes a specific file from the specified envelope.",
        "operationId": "deleteEnvelopeFile",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks": {
      "get": {
        "tags": [
          "Envelope File Task"
        ],
        "summary": "List file tasks",
        "description": "Returns the tasks of a specific envelope file.",
        "operationId": "listEnvelopeFileTasks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldTaskListResponse"
                },
                "example": {
                  "tasks": [
                    {
                      "field": {
                        "fieldType": "Signature",
                        "allowedSignatureTypes": [
                          {
                            "signatureType": "ClickToSignSignature"
                          }
                        ],
                        "qualifiedTimeStamp": true,
                        "required": false,
                        "batchGroup": "group1",
                        "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                        "positionX": 100,
                        "positionY": 200,
                        "width": 200,
                        "height": 50,
                        "page": 1,
                        "id": "sig1"
                      },
                      "recipientId": "00000000-0000-0000-0000-000000000001",
                      "sortOrder": 1,
                      "source": "UserDefined"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Envelope File Task"
        ],
        "summary": "Update file tasks",
        "description": "Replaces the tasks of a specific envelope file.",
        "operationId": "updateEnvelopeFileTasks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEnvelopeFileTasksRequest"
              },
              "examples": {
                "Signature - ClickToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "ClickToSignSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - DrawToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DrawToSignSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - TypeToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "TypeToSignSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - LocalCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "LocalCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - DisposableCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DisposableCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - Biometric": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "BiometricSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - RemoteCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "RemoteCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - OneTimePassword": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "OneTimePasswordSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - Plugin": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "PluginSignature",
                              "pluginId": "ArubaGsp"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - AutomaticSignature": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "AutomaticSignature"
                            }
                          ],
                          "required": true,
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - LocalCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "LocalCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - DisposableCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DisposableCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - RemoteCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "RemoteCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - Plugin": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "PluginSignature",
                              "pluginId": "ArubaGsp"
                            }
                          ],
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - String": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "StringType",
                            "value": "Default text",
                            "password": false,
                            "multiline": false,
                            "maxLength": 100
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Date": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "DateType",
                            "value": "2025-12-31",
                            "format": "dd.MM.yyyy",
                            "minValue": "2025-01-01",
                            "maxValue": "2026-12-31"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Number": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "NumberType",
                            "value": 42.51,
                            "thousandsSeparator": "Point",
                            "decimalSeparator": "Comma",
                            "symbol": {
                              "value": "€",
                              "position": "Start"
                            },
                            "decimalPlaces": 2,
                            "minValue": 10.25,
                            "maxValue": 1000.78
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - PhoneNumber": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "PhoneNumberType",
                            "value": "+393331234567",
                            "format": "InternationalLeadingPlus"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Time": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "TimeType",
                            "value": "14:30:00",
                            "format": "HH:mm",
                            "minValue": "08:00:00",
                            "maxValue": "18:00:00"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Checkbox": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Checkbox",
                          "checked": true,
                          "value": "yes",
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 300,
                          "width": 20,
                          "height": 20,
                          "page": 1,
                          "id": "chk1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "RadioButton": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "RadioButton",
                          "groupName": "group1",
                          "checked": false,
                          "readOnly": false,
                          "value": "option1",
                          "required": false,
                          "positionX": 100,
                          "positionY": 200,
                          "width": 20,
                          "height": 20,
                          "page": 1,
                          "id": "rb1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "DropDown": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "DropDown",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "options": [
                            {
                              "key": "val1",
                              "value": "Label 1",
                              "selected": false
                            },
                            {
                              "key": "val2",
                              "value": "Label 2",
                              "selected": true
                            }
                          ],
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 400,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "dd1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "ListBox": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "ListBox",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "options": [
                            {
                              "key": "val1",
                              "value": "Label 1",
                              "selected": false
                            },
                            {
                              "key": "val2",
                              "value": "Label 2",
                              "selected": true
                            }
                          ],
                          "multiselect": true,
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 500,
                          "width": 150,
                          "height": 80,
                          "page": 1,
                          "id": "lb1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Attachment": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Attachment",
                          "required": false,
                          "positionX": 50,
                          "positionY": 600,
                          "width": 100,
                          "height": 30,
                          "page": 1,
                          "id": "att1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Text": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Text",
                            "value": "Default text"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Date": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Date",
                            "format": "dd.MM.yyyy"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - FullName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "FullName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - FirstName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "FirstName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - LastName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "LastName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Initials": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Initials"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Email": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Email"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Link": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Link",
                          "reference": "https://example.com",
                          "positionX": 50,
                          "positionY": 700,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "lnk1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "FileReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "FileReadConfirmation",
                          "required": false,
                          "id": "frc1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "PageReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "PageReadConfirmation",
                          "required": false,
                          "page": 1,
                          "id": "prc1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "AreaReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "AreaReadConfirmation",
                          "required": false,
                          "positionX": 50,
                          "positionY": 250,
                          "width": 200,
                          "height": 100,
                          "page": 1,
                          "id": "arc1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Approval": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Approval",
                          "required": false,
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "app1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages": {
      "get": {
        "tags": [
          "Envelope Stage"
        ],
        "summary": "List envelope stages",
        "description": "Returns the stages of the specified envelope.",
        "operationId": "listEnvelopeStages",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeStageListResponse"
                },
                "example": {
                  "stages": [
                    {
                      "id": "00000000-0000-0000-0000-000000000010",
                      "name": "Stage 1",
                      "sortOrder": 1,
                      "requiredRecipientCompletions": 1,
                      "type": "Signer"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Envelope Stage"
        ],
        "summary": "Create envelope stage",
        "description": "Creates a new stage for the specified envelope.",
        "operationId": "createEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEnvelopeStageRequest"
              },
              "examples": {
                "Signer": {
                  "value": {
                    "type": "Signer",
                    "name": "Signer Stage",
                    "requiredRecipientCompletions": 1
                  }
                },
                "CarbonCopy": {
                  "value": {
                    "type": "CarbonCopy",
                    "name": "CarbonCopy Stage"
                  }
                },
                "Viewer": {
                  "value": {
                    "type": "Viewer",
                    "name": "Viewer Stage",
                    "requiredRecipientCompletions": 1
                  }
                },
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "name": "Automatic Stage"
                  }
                },
                "Approver": {
                  "value": {
                    "type": "Approver",
                    "name": "Approver Stage",
                    "requiredRecipientCompletions": 1
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateEnvelopeStageResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000010"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Envelope Stage"
        ],
        "summary": "Reorder envelope stages",
        "description": "Reorders the stages of the specified envelope.",
        "operationId": "reorderEnvelopeStages",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchEnvelopeStagesRequest"
              },
              "example": {
                "stages": [
                  {
                    "id": "00000000-0000-0000-0000-000000000001",
                    "sortOrder": 1
                  },
                  {
                    "id": "00000000-0000-0000-0000-000000000002",
                    "sortOrder": 2
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}": {
      "get": {
        "tags": [
          "Envelope Stage"
        ],
        "summary": "Get envelope stage",
        "description": "Returns a specific envelope stage.",
        "operationId": "getEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeStageResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000010",
                  "name": "Stage 1",
                  "sortOrder": 1,
                  "requiredRecipientCompletions": 1,
                  "type": "Signer",
                  "recipients": [
                    {
                      "type": "Standard",
                      "givenName": "Mario",
                      "surname": "Rossi",
                      "email": "mario.rossi@example.com",
                      "phoneNumber": "+39123456789",
                      "notificationChannels": [
                        "Email"
                      ],
                      "id": "00000000-0000-0000-0000-000000000100"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Envelope Stage"
        ],
        "summary": "Update envelope stage",
        "description": "Updates a specific envelope stage.",
        "operationId": "updateEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEnvelopeStageRequest"
              },
              "examples": {
                "Signer": {
                  "value": {
                    "name": "Signer Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Signer"
                  }
                },
                "CarbonCopy": {
                  "value": {
                    "name": "CarbonCopy Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "CarbonCopy"
                  }
                },
                "Viewer": {
                  "value": {
                    "name": "Viewer Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Viewer"
                  }
                },
                "Automatic": {
                  "value": {
                    "name": "Automatic Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Automatic"
                  }
                },
                "Approver": {
                  "value": {
                    "name": "Approver Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Approver"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Envelope Stage"
        ],
        "summary": "Delete envelope stage",
        "description": "Deletes a specific envelope stage.",
        "operationId": "deleteEnvelopeStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients": {
      "post": {
        "tags": [
          "Envelope Stage Recipient"
        ],
        "summary": "Create stage recipient",
        "description": "Creates a new recipient for the specified stage.",
        "operationId": "createEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/CreateEnvelopeAutomaticRecipientRequest"
                  },
                  {
                    "$ref": "#/components/schemas/CreateEnvelopeStandardRecipientRequest"
                  }
                ],
                "description": "Base record for create envelope recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
              },
              "examples": {
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "signatureProfile": "default-eseal-profile",
                    "signatureReason": "I agree to the terms.",
                    "languageCode": "en"
                  }
                },
                "Standard - No authentication": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OTP SMS": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oneTimePassword": {
                        "channel": "Sms"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Access code": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "accessCode": {
                        "code": "1234"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OAuth": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oAuthAuthentications": [
                        {
                          "providerName": "google",
                          "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                        }
                      ]
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Disposable certificate": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "signatureConfiguration": {
                      "disposableCertificate": {
                        "document": {
                          "type": "IdentityCard",
                          "number": "AA1234567",
                          "serialNumber": "SN-0001",
                          "issuingCountry": "IT",
                          "issuedBy": "Comune di Roma",
                          "issuedOn": "2020-01-15T00:00:00+00:00",
                          "expiresAt": "2030-01-15T00:00:00+00:00"
                        },
                        "identification": {
                          "type": "NationalIdentityCard",
                          "issuingCountry": "IT"
                        },
                        "verificationPhoneNumber": "+39123456789"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateEnvelopeRecipientResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000100"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients/{recipientId}": {
      "get": {
        "tags": [
          "Envelope Stage Recipient"
        ],
        "summary": "Get stage recipient",
        "description": "Returns a specific stage recipient.",
        "operationId": "getEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/EnvelopeStandardRecipientResponse"
                    },
                    {
                      "$ref": "#/components/schemas/EnvelopeAutomaticRecipientResponse"
                    }
                  ],
                  "description": "Detailed representation of a recipient. Base for polymorphic response."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Envelope Stage Recipient"
        ],
        "summary": "Update stage recipient",
        "description": "Updates a specific stage recipient.",
        "operationId": "updateEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/UpdateEnvelopeAutomaticRecipientRequest"
                  },
                  {
                    "$ref": "#/components/schemas/UpdateEnvelopeStandardRecipientRequest"
                  }
                ],
                "description": "Base record for update envelope recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
              },
              "examples": {
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "signatureProfile": "default-eseal-profile",
                    "signatureReason": "I agree to the terms.",
                    "languageCode": "en"
                  }
                },
                "Standard - No authentication": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OTP SMS": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oneTimePassword": {
                        "channel": "Sms"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Access code": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "accessCode": {
                        "code": "1234"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OAuth": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oAuthAuthentications": [
                        {
                          "providerName": "google",
                          "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                        }
                      ]
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Disposable certificate": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "signatureConfiguration": {
                      "disposableCertificate": {
                        "document": {
                          "type": "IdentityCard",
                          "number": "AA1234567",
                          "serialNumber": "SN-0001",
                          "issuingCountry": "IT",
                          "issuedBy": "Comune di Roma",
                          "issuedOn": "2020-01-15T00:00:00+00:00",
                          "expiresAt": "2030-01-15T00:00:00+00:00"
                        },
                        "identification": {
                          "type": "NationalIdentityCard",
                          "issuingCountry": "IT"
                        },
                        "verificationPhoneNumber": "+39123456789"
                      }
                    },
                    "personalMessage": "Please review and sign the attached contract.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Envelope Stage Recipient"
        ],
        "summary": "Delete stage recipient",
        "description": "Deletes a specific stage recipient.",
        "operationId": "deleteEnvelopeStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/envelope/agreement": {
      "get": {
        "tags": [
          "Organization Settings Envelope"
        ],
        "summary": "Get agreement settings",
        "description": "Returns the envelope agreement configuration for the specified organization.",
        "operationId": "getAgreementSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgreementSettings"
                },
                "example": {
                  "enabled": true,
                  "overridable": false,
                  "agreements": [
                    {
                      "language": "en",
                      "title": "Terms of Service",
                      "body": "By signing this document you agree to our terms."
                    },
                    {
                      "language": "it",
                      "title": "Termini di Servizio",
                      "body": "Firmando questo documento accetti i nostri termini."
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Organization Settings Envelope"
        ],
        "summary": "Update agreement settings",
        "description": "Replaces the envelope agreement configuration for the specified organization.",
        "operationId": "updateAgreementSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgreementSettings"
              },
              "example": {
                "enabled": true,
                "overridable": false,
                "agreements": [
                  {
                    "language": "en",
                    "title": "Terms of Service",
                    "body": "By signing this document you agree to our terms."
                  },
                  {
                    "language": "it",
                    "title": "Termini di Servizio",
                    "body": "Firmando questo documento accetti i nostri termini."
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/general": {
      "get": {
        "tags": [
          "Organization Settings General"
        ],
        "summary": "Get general settings",
        "description": "Returns the general configuration for the specified organization.",
        "operationId": "getGeneralSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeneralSettings"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Organization Settings General"
        ],
        "summary": "Update general settings",
        "description": "Updates the general configuration for the specified organization.",
        "operationId": "updateGeneralSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGeneralSettingsRequest"
              },
              "example": {
                "name": "name"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/general/languages": {
      "get": {
        "tags": [
          "Organization Settings General"
        ],
        "summary": "Get language settings",
        "description": "Returns the languages enabled for the specified organization, in alphabetical order.",
        "operationId": "getLanguageSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LanguageSettings"
                },
                "example": {
                  "languages": [
                    "de",
                    "en",
                    "it"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Organization Settings General"
        ],
        "summary": "Update language settings",
        "description": "Replaces the languages enabled for the specified organization.",
        "operationId": "updateLanguageSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLanguageSettingsRequest"
              },
              "example": {
                "languages": [
                  "en",
                  "it",
                  "de"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/general/regional": {
      "get": {
        "tags": [
          "Organization Settings General"
        ],
        "summary": "Get regional defaults settings",
        "description": "Returns the default language, time zone and date-time format for the specified organization.",
        "operationId": "getRegionalDefaultsSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegionalDefaultsSettings"
                },
                "example": {
                  "timeZone": "Europe/Berlin",
                  "dateTimeFormat": "dd/MM/yyyy | HH:mm",
                  "language": "en"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Organization Settings General"
        ],
        "summary": "Update regional defaults settings",
        "description": "Replaces the default language, time zone and date-time format for the specified organization.",
        "operationId": "updateRegionalDefaultsSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRegionalDefaultsSettingsRequest"
              },
              "example": {
                "timeZone": "Europe/Berlin",
                "dateTimeFormat": "dd/MM/yyyy | HH:mm",
                "language": "en"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/recipient": {
      "get": {
        "tags": [
          "Organization Settings Recipient"
        ],
        "summary": "Get recipient settings",
        "description": "Returns the recipient configuration for the specified organization.",
        "operationId": "getRecipientSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecipientSettings"
                },
                "examples": {
                  "Mandatory authentication - None": {
                    "value": {
                      "sendCompletedFileToAllRecipients": true,
                      "warnIfRecipientsHaveNoFields": true,
                      "authentications": {
                        "accessCode": true,
                        "oneTimePassword": {
                          "enabled": true
                        }
                      },
                      "recipientDelegation": "allowedEnabled",
                      "mandatoryAuthentication": {
                        "authentication": "None"
                      }
                    }
                  },
                  "Mandatory authentication - Any": {
                    "value": {
                      "sendCompletedFileToAllRecipients": true,
                      "warnIfRecipientsHaveNoFields": true,
                      "authentications": {
                        "accessCode": true,
                        "oneTimePassword": {
                          "enabled": true
                        }
                      },
                      "recipientDelegation": "allowedEnabled",
                      "mandatoryAuthentication": {
                        "authentication": "Any"
                      }
                    }
                  },
                  "Mandatory authentication - AccessCode": {
                    "value": {
                      "sendCompletedFileToAllRecipients": true,
                      "warnIfRecipientsHaveNoFields": true,
                      "authentications": {
                        "accessCode": true,
                        "oneTimePassword": {
                          "enabled": true
                        }
                      },
                      "recipientDelegation": "allowedEnabled",
                      "mandatoryAuthentication": {
                        "authentication": "AccessCode"
                      }
                    }
                  },
                  "Mandatory authentication - OneTimePassword": {
                    "value": {
                      "sendCompletedFileToAllRecipients": true,
                      "warnIfRecipientsHaveNoFields": true,
                      "authentications": {
                        "accessCode": true,
                        "oneTimePassword": {
                          "enabled": true
                        }
                      },
                      "recipientDelegation": "allowedEnabled",
                      "mandatoryAuthentication": {
                        "authentication": "OneTimePassword"
                      }
                    }
                  },
                  "Mandatory authentication - OAuth": {
                    "value": {
                      "sendCompletedFileToAllRecipients": true,
                      "warnIfRecipientsHaveNoFields": true,
                      "authentications": {
                        "accessCode": true,
                        "oneTimePassword": {
                          "enabled": true
                        }
                      },
                      "recipientDelegation": "allowedEnabled",
                      "mandatoryAuthentication": {
                        "authentication": "OAuth",
                        "oAuthProviderId": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Organization Settings Recipient"
        ],
        "summary": "Update recipient settings",
        "description": "Updates the recipient configuration for the specified organization.",
        "operationId": "updateRecipientSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRecipientSettingsRequest"
              },
              "examples": {
                "Mandatory authentication - None": {
                  "value": {
                    "sendCompletedFileToAllRecipients": true,
                    "warnIfRecipientsHaveNoFields": true,
                    "authentications": {
                      "accessCode": true,
                      "oneTimePassword": {
                        "enabled": true
                      }
                    },
                    "recipientDelegation": "allowedEnabled",
                    "mandatoryAuthentication": {
                      "authentication": "None"
                    }
                  }
                },
                "Mandatory authentication - Any": {
                  "value": {
                    "sendCompletedFileToAllRecipients": true,
                    "warnIfRecipientsHaveNoFields": true,
                    "authentications": {
                      "accessCode": true,
                      "oneTimePassword": {
                        "enabled": true
                      }
                    },
                    "recipientDelegation": "allowedEnabled",
                    "mandatoryAuthentication": {
                      "authentication": "Any"
                    }
                  }
                },
                "Mandatory authentication - AccessCode": {
                  "value": {
                    "sendCompletedFileToAllRecipients": true,
                    "warnIfRecipientsHaveNoFields": true,
                    "authentications": {
                      "accessCode": true,
                      "oneTimePassword": {
                        "enabled": true
                      }
                    },
                    "recipientDelegation": "allowedEnabled",
                    "mandatoryAuthentication": {
                      "authentication": "AccessCode"
                    }
                  }
                },
                "Mandatory authentication - OneTimePassword": {
                  "value": {
                    "sendCompletedFileToAllRecipients": true,
                    "warnIfRecipientsHaveNoFields": true,
                    "authentications": {
                      "accessCode": true,
                      "oneTimePassword": {
                        "enabled": true
                      }
                    },
                    "recipientDelegation": "allowedEnabled",
                    "mandatoryAuthentication": {
                      "authentication": "OneTimePassword"
                    }
                  }
                },
                "Mandatory authentication - OAuth": {
                  "value": {
                    "sendCompletedFileToAllRecipients": true,
                    "warnIfRecipientsHaveNoFields": true,
                    "authentications": {
                      "accessCode": true,
                      "oneTimePassword": {
                        "enabled": true
                      }
                    },
                    "recipientDelegation": "allowedEnabled",
                    "mandatoryAuthentication": {
                      "authentication": "OAuth",
                      "oAuthProviderId": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                    }
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/recipient/oauth-providers": {
      "get": {
        "tags": [
          "Organization Settings Recipient"
        ],
        "summary": "List OAuth providers",
        "description": "Returns a paginated list of OAuth providers configured for the specified organization.",
        "operationId": "listOAuthProviders",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthProviderListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/signature": {
      "get": {
        "tags": [
          "Organization Settings Signature"
        ],
        "summary": "Get signature settings",
        "description": "Returns the signature configuration for the specified organization.",
        "operationId": "getSignatureSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignatureSettings"
                },
                "example": {
                  "defaultSignatureType": "ClickToSign",
                  "auditTrailMode": "Standard",
                  "timestamp": {
                    "url": "https://timestamp.example.com",
                    "username": "tsa-user",
                    "hashAlgorithm": "SHA-256"
                  },
                  "disposableCertificate": {
                    "showDisclaimerBeforeCertificateRequest": true,
                    "sendDisposableDisclaimerDocumentNotifications": true,
                    "lraId": "LRA-001",
                    "user": "lra-user",
                    "disposableType": "Disposable"
                  },
                  "defaultSignatureLayoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Organization Settings Signature"
        ],
        "summary": "Update signature settings",
        "description": "Updates the signature configuration for the specified organization.",
        "operationId": "updateSignatureSettings",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSignatureSettingsRequest"
              },
              "example": {
                "defaultSignatureType": "ClickToSign",
                "auditTrailMode": "Standard",
                "timestamp": {
                  "url": "https://timestamp.example.com",
                  "username": "tsa-user",
                  "password": "P@ssw0rd!",
                  "hashAlgorithm": "SHA-256"
                },
                "disposableCertificate": {
                  "lraId": "LRA-001",
                  "user": "lra-user",
                  "password": "P@ssw0rd!",
                  "disposableType": "Disposable",
                  "showDisclaimerBeforeCertificateRequest": true,
                  "sendDisposableDisclaimerDocumentNotifications": true
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/signature/layouts": {
      "get": {
        "tags": [
          "Organization Settings Signature"
        ],
        "summary": "List signature layouts",
        "description": "Returns the identifier and name of the signature layouts of the specified organization.",
        "operationId": "listSignatureLayouts",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignatureLayoutListResponse"
                },
                "example": {
                  "layouts": [
                    {
                      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                      "name": "Default layout"
                    },
                    {
                      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
                      "name": "Compact layout"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Organization Settings Signature"
        ],
        "summary": "Create a signature layout",
        "description": "Creates a signature layout for the specified organization and returns its identifier. The `name` is a slug of 1-50 characters (letters, digits and hyphens, not starting or ending with a hyphen), unique within the organization; `default` is reserved. When the `dateTime` row is visible, `format` must be one of the `code` values returned by GET /api/v1/datetime-formats and `localTimezone` is required: when it is false, `timezone` must be exactly one of the `code` values returned by GET /api/v1/timezones; when it is true, `timezone` must be omitted. The optional image accepts the MIME types image/png, image/jpeg, image/gif and image/webp, up to 716800 base64 characters (about 512 KB). Validation errors are returned as 422.",
        "operationId": "createSignatureLayout",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SignatureLayoutRequest"
              },
              "example": {
                "name": "compact-layout",
                "fields": {
                  "signerName": {
                    "visible": true
                  },
                  "signerEmail": {
                    "visible": true
                  },
                  "ipAddress": {
                    "visible": false
                  },
                  "reason": {
                    "visible": true
                  },
                  "dateTime": {
                    "visible": true,
                    "format": "dd/MM/yyyy | HH:mm",
                    "localTimezone": false,
                    "timezone": "Europe/Berlin"
                  },
                  "customText": {
                    "visible": false
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateSignatureLayoutResponse"
                },
                "example": {
                  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/signature/layouts/{layoutId}": {
      "get": {
        "tags": [
          "Organization Settings Signature"
        ],
        "summary": "Get a signature layout",
        "description": "Returns the full configuration of a signature layout of the specified organization: the fields shown in the signature appearance and the optional image. In the response, `localTimezone` is always set and `timezone` is null when `localTimezone` is true.",
        "operationId": "getSignatureLayout",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "layoutId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignatureLayout"
                },
                "example": {
                  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                  "name": "compact-layout",
                  "fields": {
                    "signerName": {
                      "visible": true
                    },
                    "signerEmail": {
                      "visible": true
                    },
                    "ipAddress": {
                      "visible": false
                    },
                    "reason": {
                      "visible": true
                    },
                    "dateTime": {
                      "visible": true,
                      "format": "dd/MM/yyyy | HH:mm",
                      "localTimezone": false,
                      "timezone": "Europe/Berlin"
                    },
                    "customText": {
                      "visible": false
                    }
                  },
                  "image": null
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Organization Settings Signature"
        ],
        "summary": "Replace a signature layout",
        "description": "Replaces the whole signature layout, image included: omitting `image` removes it. The same rules of the creation apply. The layout named `default` cannot be renamed.",
        "operationId": "updateSignatureLayout",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "layoutId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SignatureLayoutRequest"
              },
              "example": {
                "name": "compact-layout",
                "fields": {
                  "signerName": {
                    "visible": true
                  },
                  "signerEmail": {
                    "visible": true
                  },
                  "ipAddress": {
                    "visible": false
                  },
                  "reason": {
                    "visible": true
                  },
                  "dateTime": {
                    "visible": true,
                    "format": "dd/MM/yyyy | HH:mm",
                    "localTimezone": false,
                    "timezone": "Europe/Berlin"
                  },
                  "customText": {
                    "visible": false
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Organization Settings Signature"
        ],
        "summary": "Delete a signature layout",
        "description": "Deletes a signature layout of the specified organization. The layout named `default` cannot be deleted.",
        "operationId": "deleteSignatureLayout",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "layoutId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/user/business-roles": {
      "get": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "List business roles",
        "description": "Returns a paginated list of business roles for the specified organization.",
        "operationId": "listBusinessRoles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "SortingKey",
            "in": "query",
            "description": "Optional sorting key.",
            "schema": {
              "$ref": "#/components/schemas/BusinessRolesSortingKey"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Whether to sort in ascending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BusinessRoleListResponse"
                },
                "example": {
                  "items": [
                    {
                      "id": "648673bd-1a8d-4cc6-a5b9-b626fcc58d79",
                      "name": "Approver",
                      "description": "Approves envelopes before completion."
                    },
                    {
                      "id": "77574b95-24c8-420d-9b08-9cd22b8cc75a",
                      "name": "Reviewer",
                      "description": null
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 10,
                    "totalCount": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Create business role",
        "description": "Creates a new business role with the specified name and optional description.",
        "operationId": "createBusinessRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBusinessRoleRequest"
              },
              "example": {
                "name": "Approver",
                "description": "Approves envelopes before completion."
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateBusinessRoleResponse"
                },
                "example": {
                  "id": "ced2dd3e-fade-447d-8fcb-118d0a4fb754"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/user/business-roles/{businessRoleId}": {
      "get": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Get business role",
        "description": "Returns the details of the specified business role.",
        "operationId": "getBusinessRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/businessRoleId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BusinessRoleDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Update business role",
        "description": "Replaces the name and description of the specified business role.",
        "operationId": "updateBusinessRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/businessRoleId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBusinessRoleRequest"
              },
              "example": {
                "name": "Approver",
                "description": "Approves envelopes before completion."
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Delete business role",
        "description": "Deletes the specified business role.",
        "operationId": "deleteBusinessRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/businessRoleId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/user/application-roles": {
      "get": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "List application roles",
        "description": "Returns a paginated list of application roles for the specified organization.",
        "operationId": "listApplicationRoles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "SortingKey",
            "in": "query",
            "description": "Optional sorting key.",
            "schema": {
              "$ref": "#/components/schemas/ApplicationRoleSortingKey"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Optional sort direction.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationRoleListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Create application role",
        "description": "Creates a new custom application role with the specified name, optional description, and permissions.",
        "operationId": "createApplicationRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApplicationRoleRequest"
              },
              "example": {
                "name": "Contract Reviewer",
                "permissions": [
                  {
                    "entity": "Envelope",
                    "action": "Read"
                  },
                  {
                    "entity": "Template",
                    "action": "Read"
                  }
                ],
                "description": "Can read envelopes and templates"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateApplicationRoleResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/settings/user/application-roles/{applicationRoleId}": {
      "get": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Get application role",
        "description": "Returns the full details of the specified application role.",
        "operationId": "getApplicationRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/applicationRoleId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationRoleResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Update application role",
        "description": "Replaces the name, description, and permissions of the specified application role.",
        "operationId": "updateApplicationRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/applicationRoleId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateApplicationRoleRequest"
              },
              "example": {
                "name": "Contract Reviewer",
                "permissions": [
                  {
                    "entity": "Envelope",
                    "action": "Read"
                  },
                  {
                    "entity": "Template",
                    "action": "Read"
                  }
                ],
                "description": "Can read envelopes and templates"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Organization Settings User"
        ],
        "summary": "Delete application role",
        "description": "Deletes the specified custom application role.",
        "operationId": "deleteApplicationRole",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/applicationRoleId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/policies": {
      "get": {
        "tags": [
          "Policy"
        ],
        "summary": "List policies",
        "description": "Returns a paginated list of policies for the specified organization.",
        "operationId": "listPolicies",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "SearchText",
            "in": "query",
            "description": "Optional free-text filter.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "DocumentClassId",
            "in": "query",
            "description": "Optional document class filter.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "SortingKey",
            "in": "query",
            "description": "Optional sorting key.",
            "schema": {
              "$ref": "#/components/schemas/PolicySortingKey"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Optional sort direction.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyListResponse"
                },
                "example": {
                  "policies": [
                    {
                      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                      "name": "Standard signing policy",
                      "isActive": true,
                      "description": "Policy applied to all standard signing envelopes"
                    },
                    {
                      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
                      "name": "Approval policy",
                      "isActive": false,
                      "description": null
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 10,
                    "totalCount": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Policy"
        ],
        "summary": "Create policy",
        "description": "Creates a new policy with the specified conditions and actions for the specified organization.",
        "operationId": "createPolicy",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePolicyRequest"
              },
              "examples": {
                "minimal (no conditions or actions)": {
                  "value": {
                    "name": "Standard signing policy",
                    "isActive": true,
                    "conditions": [],
                    "actions": []
                  }
                },
                "condition - StringType": {
                  "value": {
                    "name": "Invoice policy",
                    "isActive": true,
                    "description": "Applies to invoice documents",
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "Equals",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "StringType",
                          "value": "Invoice",
                          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "condition - NumberType": {
                  "value": {
                    "name": "High-value contract policy",
                    "isActive": true,
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "GreaterThan",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "NumberType",
                          "value": 1000,
                          "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "condition - DateType": {
                  "value": {
                    "name": "Due-date policy",
                    "isActive": true,
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "LessThan",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "DateType",
                          "value": "2026-01-01",
                          "id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "condition - ListOptionType": {
                  "value": {
                    "name": "Contract category policy",
                    "isActive": true,
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "Equals",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "ListOptionType",
                          "value": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
                          "id": "e8c9d2b4-9f3a-4b1d-8b2e-6c8a1f2d3e4b"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "action - recipientSource Static": {
                  "value": {
                    "name": "Standard signing policy",
                    "isActive": true,
                    "description": "Policy applied to all standard signing envelopes",
                    "conditions": [],
                    "actions": [
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Signer Stage",
                          "type": "Signer",
                          "requiredRecipientCompletions": 1
                        },
                        "recipientSource": {
                          "type": "Static",
                          "recipients": [
                            {
                              "givenName": "Jane",
                              "surname": "Doe",
                              "email": "jane.doe@example.com",
                              "phoneNumber": "+1 555 0100"
                            }
                          ]
                        },
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "action - recipientSource Dynamic": {
                  "value": {
                    "name": "Approval policy",
                    "isActive": true,
                    "conditions": [],
                    "actions": [
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Approval Stage",
                          "type": "Approver",
                          "requiredRecipientCompletions": 1
                        },
                        "recipientSource": {
                          "type": "Dynamic",
                          "userGroupId": "9b2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
                          "businessRoleId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
                        },
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "complete (conditions and actions)": {
                  "value": {
                    "name": "High-value invoice approval policy",
                    "isActive": true,
                    "description": "Routes high-value invoices to an approver before signing",
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "Equals",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "StringType",
                          "value": "Invoice",
                          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                        }
                      },
                      {
                        "operator": "GreaterThan",
                        "sortOrder": 2,
                        "metadata": {
                          "type": "NumberType",
                          "value": 1000,
                          "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
                        }
                      }
                    ],
                    "actions": [
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Approval Stage",
                          "type": "Approver",
                          "requiredRecipientCompletions": 1
                        },
                        "recipientSource": {
                          "type": "Dynamic",
                          "userGroupId": "9b2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
                          "businessRoleId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
                        },
                        "sortOrder": 1
                      },
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Signer Stage",
                          "type": "Signer",
                          "requiredRecipientCompletions": 2
                        },
                        "recipientSource": {
                          "type": "Static",
                          "recipients": [
                            {
                              "givenName": "Jane",
                              "surname": "Doe",
                              "email": "jane.doe@example.com",
                              "phoneNumber": "+1 555 0100"
                            }
                          ]
                        },
                        "sortOrder": 2
                      }
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreatedPolicyResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/policies/{policyId}": {
      "get": {
        "tags": [
          "Policy"
        ],
        "summary": "Get policy",
        "description": "Returns the full policy, including its conditions and actions, for the specified organization.",
        "operationId": "getPolicy",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "policyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyResponse"
                },
                "example": {
                  "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
                  "name": "Standard signing policy",
                  "isActive": true,
                  "description": "Policy applied to all standard signing envelopes",
                  "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                  "conditions": [
                    {
                      "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
                      "operator": "Equals",
                      "sortOrder": 0,
                      "metadata": {
                        "type": "StringType",
                        "value": "Invoice",
                        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                      }
                    },
                    {
                      "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
                      "operator": "GreaterThan",
                      "sortOrder": 1,
                      "metadata": {
                        "type": "NumberType",
                        "value": 1000,
                        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
                      }
                    },
                    {
                      "id": "3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f",
                      "operator": "LessThan",
                      "sortOrder": 2,
                      "metadata": {
                        "type": "DateType",
                        "value": "2026-01-01",
                        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
                      }
                    },
                    {
                      "id": "4d5e6f7a-8b9c-4d0e-1f2a-3b4c5d6e7f8a",
                      "operator": "Equals",
                      "sortOrder": 3,
                      "metadata": {
                        "type": "ListOptionType",
                        "value": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
                        "id": "e8c9d2b4-9f3a-4b1d-8b2e-6c8a1f2d3e4b"
                      }
                    }
                  ],
                  "actions": [
                    {
                      "id": "5e6f7a8b-9c0d-4e1f-2a3b-4c5d6e7f8a9b",
                      "type": "AddEnvelopeStageConfiguration",
                      "stage": {
                        "name": "Signer Stage",
                        "type": "Signer",
                        "requiredRecipientCompletions": 1
                      },
                      "recipientSource": {
                        "type": "Static",
                        "recipients": [
                          {
                            "givenName": "Jane",
                            "surname": "Doe",
                            "email": "jane.doe@example.com",
                            "phoneNumber": "+1 555 0100"
                          }
                        ]
                      },
                      "sortOrder": 0
                    },
                    {
                      "id": "6f7a8b9c-0d1e-4f2a-3b4c-5d6e7f8a9b0c",
                      "type": "AddEnvelopeStageConfiguration",
                      "stage": {
                        "name": "Approval Stage",
                        "type": "Approver",
                        "requiredRecipientCompletions": 1
                      },
                      "recipientSource": {
                        "type": "Dynamic",
                        "userGroupId": "7f8a9b0c-1d2e-4f3a-4b5c-6d7e8f9a0b1c",
                        "businessRoleId": "8a9b0c1d-2e3f-4a4b-5c6d-7e8f9a0b1c2d"
                      },
                      "sortOrder": 1
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Policy"
        ],
        "summary": "Update policy",
        "description": "Updates a specific policy.",
        "operationId": "updatePolicy",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "policyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePolicyRequest"
              },
              "examples": {
                "minimal (no conditions or actions)": {
                  "value": {
                    "name": "Standard signing policy",
                    "isActive": true,
                    "conditions": [],
                    "actions": []
                  }
                },
                "condition - StringType": {
                  "value": {
                    "name": "Invoice policy",
                    "isActive": true,
                    "description": "Applies to invoice documents",
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "Equals",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "StringType",
                          "value": "Invoice",
                          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "condition - NumberType": {
                  "value": {
                    "name": "High-value contract policy",
                    "isActive": true,
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "GreaterThan",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "NumberType",
                          "value": 1000,
                          "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "condition - DateType": {
                  "value": {
                    "name": "Due-date policy",
                    "isActive": true,
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "LessThan",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "DateType",
                          "value": "2026-01-01",
                          "id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "condition - ListOptionType": {
                  "value": {
                    "name": "Contract category policy",
                    "isActive": true,
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "Equals",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "ListOptionType",
                          "value": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
                          "id": "e8c9d2b4-9f3a-4b1d-8b2e-6c8a1f2d3e4b"
                        }
                      }
                    ],
                    "actions": []
                  }
                },
                "action - recipientSource Static": {
                  "value": {
                    "name": "Standard signing policy",
                    "isActive": true,
                    "description": "Policy applied to all standard signing envelopes",
                    "conditions": [],
                    "actions": [
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Signer Stage",
                          "type": "Signer",
                          "requiredRecipientCompletions": 1
                        },
                        "recipientSource": {
                          "type": "Static",
                          "recipients": [
                            {
                              "givenName": "Jane",
                              "surname": "Doe",
                              "email": "jane.doe@example.com",
                              "phoneNumber": "+1 555 0100"
                            }
                          ]
                        },
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "action - recipientSource Dynamic": {
                  "value": {
                    "name": "Approval policy",
                    "isActive": true,
                    "conditions": [],
                    "actions": [
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Approval Stage",
                          "type": "Approver",
                          "requiredRecipientCompletions": 1
                        },
                        "recipientSource": {
                          "type": "Dynamic",
                          "userGroupId": "9b2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
                          "businessRoleId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
                        },
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "complete (conditions and actions)": {
                  "value": {
                    "name": "High-value invoice approval policy",
                    "isActive": true,
                    "description": "Routes high-value invoices to an approver before signing",
                    "documentClassId": "6ecd8c99-4036-403d-bf84-cf8400f67836",
                    "conditions": [
                      {
                        "operator": "Equals",
                        "sortOrder": 1,
                        "metadata": {
                          "type": "StringType",
                          "value": "Invoice",
                          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                        }
                      },
                      {
                        "operator": "GreaterThan",
                        "sortOrder": 2,
                        "metadata": {
                          "type": "NumberType",
                          "value": 1000,
                          "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
                        }
                      }
                    ],
                    "actions": [
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Approval Stage",
                          "type": "Approver",
                          "requiredRecipientCompletions": 1
                        },
                        "recipientSource": {
                          "type": "Dynamic",
                          "userGroupId": "9b2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
                          "businessRoleId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
                        },
                        "sortOrder": 1
                      },
                      {
                        "type": "AddEnvelopeStageConfiguration",
                        "stage": {
                          "name": "Signer Stage",
                          "type": "Signer",
                          "requiredRecipientCompletions": 2
                        },
                        "recipientSource": {
                          "type": "Static",
                          "recipients": [
                            {
                              "givenName": "Jane",
                              "surname": "Doe",
                              "email": "jane.doe@example.com",
                              "phoneNumber": "+1 555 0100"
                            }
                          ]
                        },
                        "sortOrder": 2
                      }
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Policy"
        ],
        "summary": "Delete policy",
        "description": "Deletes the specified policy.",
        "operationId": "deletePolicy",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "policyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates": {
      "get": {
        "tags": [
          "Template"
        ],
        "summary": "List templates",
        "description": "Returns a paginated list of templates for the specified organization.",
        "operationId": "listTemplates",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "UpdatedBefore",
            "in": "query",
            "description": "Filter templates updated before this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "UpdatedAfter",
            "in": "query",
            "description": "Filter templates updated after this date.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateListResponse"
                },
                "example": {
                  "templates": [
                    {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Standard NDA template",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 50,
                    "totalCount": 1
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Template"
        ],
        "summary": "Create template",
        "description": "Creates a new template within the specified organization.",
        "operationId": "createTemplate",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTemplateRequest"
              },
              "examples": {
                "PAdES, absolute expiration (default)": {
                  "value": {
                    "name": "Standard NDA template",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.3574952+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": true,
                    "signatureReason": "Approved by Mario Rossi",
                    "afterSendRedirectUrl": "https://example.com/envelope-sent"
                  }
                },
                "PAdES, relative expiration": {
                  "value": {
                    "name": "Standard NDA template",
                    "expiration": {
                      "mode": "Relative",
                      "afterSendInSeconds": 604800
                    },
                    "reminder": {
                      "enabled": false,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": false,
                    "signatureReason": "Approved by Mario Rossi"
                  }
                },
                "CAdES": {
                  "value": {
                    "name": "Standard NDA template",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.3575505+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "signatureFormat": "Cades"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateTemplateResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000001"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}": {
      "get": {
        "tags": [
          "Template"
        ],
        "summary": "Get template",
        "description": "Returns a specific template.",
        "operationId": "getTemplate",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateResponse"
                },
                "examples": {
                  "PAdES, absolute expiration (default)": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Standard NDA template",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Absolute",
                        "expiresAt": "2026-12-11T14:00:03.3629867+00:00"
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "nda.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Pades",
                      "signatureReason": "Approved by Mario Rossi",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/envelope-sent"
                    }
                  },
                  "PAdES, relative expiration": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Standard NDA template",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Relative",
                        "afterSendInSeconds": 604800
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "nda.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Pades",
                      "signatureReason": "Approved by Mario Rossi",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/envelope-sent"
                    }
                  },
                  "CAdES": {
                    "value": {
                      "id": "00000000-0000-0000-0000-000000000001",
                      "name": "Standard NDA template",
                      "createdAt": "2025-01-01T10:00:00+00:00",
                      "updatedAt": "2025-01-01T10:00:00+00:00",
                      "expiration": {
                        "mode": "Absolute",
                        "expiresAt": "2026-12-11T14:00:03.3630626+00:00"
                      },
                      "reminder": {
                        "enabled": true,
                        "firstReminderInDays": 5,
                        "resendIntervalInDays": 3,
                        "beforeExpirationInDays": 2
                      },
                      "stages": [
                        {
                          "id": "00000000-0000-0000-0000-000000000010",
                          "name": "Stage 1",
                          "sortOrder": 1
                        }
                      ],
                      "files": [
                        {
                          "id": "00000000-0000-0000-0000-000000000020",
                          "name": "nda.pdf",
                          "sortOrder": 1
                        }
                      ],
                      "qualifiedTimeStamp": true,
                      "signatureFormat": "Cades",
                      "signatureReason": "Approved by Mario Rossi",
                      "agreements": null,
                      "fileRestrictedVisibility": false,
                      "afterSendRedirectUrl": "https://example.com/envelope-sent"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Template"
        ],
        "summary": "Update template",
        "description": "Updates a specific template.",
        "operationId": "updateTemplate",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTemplateRequest"
              },
              "examples": {
                "PAdES, absolute expiration (default)": {
                  "value": {
                    "name": "Updated NDA template",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.3673258+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": true,
                    "signatureReason": "Approved by Mario Rossi",
                    "afterSendRedirectUrl": "https://example.com/envelope-sent"
                  }
                },
                "PAdES, relative expiration": {
                  "value": {
                    "name": "Updated NDA template",
                    "expiration": {
                      "mode": "Relative",
                      "afterSendInSeconds": 604800
                    },
                    "reminder": {
                      "enabled": false,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "qualifiedTimeStamp": false,
                    "signatureReason": "Approved by Mario Rossi"
                  }
                },
                "CAdES": {
                  "value": {
                    "name": "Updated NDA template",
                    "expiration": {
                      "mode": "Absolute",
                      "expiresAt": "2026-12-11T14:00:03.3673869+00:00"
                    },
                    "reminder": {
                      "enabled": true,
                      "firstReminderInDays": 5,
                      "resendIntervalInDays": 3,
                      "beforeExpirationInDays": 2
                    },
                    "signatureFormat": "Cades"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Template"
        ],
        "summary": "Delete template",
        "description": "Deletes a specific template.",
        "operationId": "deleteTemplate",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/create-envelope": {
      "post": {
        "tags": [
          "Template Action"
        ],
        "summary": "Create envelope from template",
        "description": "Creates a new draft envelope from the specified template.",
        "operationId": "createEnvelopeFromTemplate",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateEnvelopeFromTemplateResponse"
                },
                "example": {
                  "createdEnvelopeId": "00000000-0000-0000-0000-000000000200"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/files": {
      "get": {
        "tags": [
          "Template File"
        ],
        "summary": "List template files",
        "description": "Returns the files of the specified template.",
        "operationId": "listTemplateFiles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateFileListResponse"
                },
                "example": {
                  "files": [
                    {
                      "id": "00000000-0000-0000-0000-000000000020",
                      "name": "nda.pdf",
                      "sortOrder": 1
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Template File"
        ],
        "summary": "Upload template file",
        "description": "Adds a new file to the specified template. The request body provides the file content (multipart/form-data) and, optionally, an initial document class assignment. Metadata values for the document class must be set afterwards via Update file properties.",
        "operationId": "uploadTemplateFile",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "required": [
                  "file"
                ],
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  },
                  "documentClassId": {
                    "type": "string",
                    "format": "uuid",
                    "example": ""
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                },
                "documentClassId": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadTemplateFileResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000020"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Template File"
        ],
        "summary": "Reorder template files",
        "description": "Reorders the files of the specified template.",
        "operationId": "reorderTemplateFiles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchTemplateFilesRequest"
              },
              "example": {
                "files": [
                  {
                    "id": "00000000-0000-0000-0000-000000000001",
                    "sortOrder": 1
                  },
                  {
                    "id": "00000000-0000-0000-0000-000000000002",
                    "sortOrder": 2
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/files/{fileId}": {
      "get": {
        "tags": [
          "Template File"
        ],
        "summary": "Get file properties",
        "description": "Returns the properties of a specific template file, including the assigned document class and its metadata values. Does not include the file content.",
        "operationId": "getTemplateFileDetail",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateFileDetailResponse"
                },
                "example": {
                  "documentClass": {
                    "id": "c854209d-7589-4088-9627-3040ad975178",
                    "name": "Contract",
                    "metadata": [
                      {
                        "type": "NumberType",
                        "value": 100.9,
                        "id": "5140a458-6c85-41f3-aed0-87b3b84bb200",
                        "name": "Amount"
                      },
                      {
                        "type": "StringType",
                        "value": "New contract",
                        "id": "fbca9fc4-ab41-43c9-85d1-c895d357ca96",
                        "name": "Title"
                      },
                      {
                        "type": "DateType",
                        "value": "2026-05-20",
                        "id": "aaa366de-e3ce-43c7-aee6-98fca2ec15a8",
                        "name": "SignDate"
                      },
                      {
                        "type": "ListOptionType",
                        "value": "a2717f1d-44dc-41d2-afa6-9ed7f3952682",
                        "id": "61deebc0-a2ca-4872-9f8a-16b4da6425f2",
                        "name": "ContractType"
                      }
                    ]
                  },
                  "restrictedVisibilityRecipientIds": [
                    "5d9e0078-2c40-4d34-8c6c-b621071aca82",
                    "5aad6c85-d780-4632-9483-c47b87ed9446"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Template File"
        ],
        "summary": "Update file properties",
        "description": "Updates the properties of a specific template file. Currently supports assigning a document class with metadata values. Does not modify the file content.",
        "operationId": "updateTemplateFileDetail",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTemplateFileDetailRequest"
              },
              "example": {
                "documentClass": {
                  "id": "d7de23eb-074e-4081-807f-8c1fe6705bcf",
                  "metadata": [
                    {
                      "type": "NumberType",
                      "value": 100.9,
                      "id": "d54926e0-426e-4d68-b992-3f1de0d224d0"
                    },
                    {
                      "type": "StringType",
                      "value": "New contract",
                      "id": "04eccc60-c219-41be-bdf3-74e051862e70"
                    },
                    {
                      "type": "DateType",
                      "value": "2026-05-20",
                      "id": "48bad13e-bdc7-4bc1-95c8-f7c2a7528a22"
                    },
                    {
                      "type": "ListOptionType",
                      "value": "712dd981-2250-4d64-aa93-18a8b1411439",
                      "id": "e1822bdb-f61d-4768-a521-b56c097c8c0f"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Template File"
        ],
        "summary": "Delete template file",
        "description": "Deletes a specific file from the specified template.",
        "operationId": "deleteTemplateFile",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/files/{fileId}/tasks": {
      "get": {
        "tags": [
          "Template File Task"
        ],
        "summary": "List file tasks",
        "description": "Returns the tasks of a specific template file.",
        "operationId": "listTemplateFileTasks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldTaskListResponse"
                },
                "example": {
                  "tasks": [
                    {
                      "field": {
                        "fieldType": "Signature",
                        "allowedSignatureTypes": [
                          {
                            "signatureType": "ClickToSignSignature"
                          }
                        ],
                        "qualifiedTimeStamp": true,
                        "required": false,
                        "batchGroup": "group1",
                        "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                        "positionX": 100,
                        "positionY": 200,
                        "width": 200,
                        "height": 50,
                        "page": 1,
                        "id": "sig1"
                      },
                      "recipientId": "00000000-0000-0000-0000-000000000001",
                      "sortOrder": 1,
                      "source": "UserDefined"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Template File Task"
        ],
        "summary": "Update file tasks",
        "description": "Replaces the tasks of a specific template file.",
        "operationId": "updateTemplateFileTasks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/fileId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTemplateFileTasksRequest"
              },
              "examples": {
                "Signature - ClickToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "ClickToSignSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - DrawToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DrawToSignSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - TypeToSign": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "TypeToSignSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - LocalCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "LocalCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - DisposableCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DisposableCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - Biometric": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "BiometricSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - RemoteCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "RemoteCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - OneTimePassword": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "OneTimePasswordSignature"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - Plugin": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "PluginSignature",
                              "pluginId": "ArubaGsp"
                            }
                          ],
                          "required": true,
                          "batchGroup": "group1",
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Signature - AutomaticSignature": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Signature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "AutomaticSignature"
                            }
                          ],
                          "required": true,
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - LocalCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "LocalCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - DisposableCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "DisposableCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - RemoteCertificate": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "RemoteCertificateSignature"
                            }
                          ],
                          "qualifiedTimeStamp": true,
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "InvisibleSignature - Plugin": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "InvisibleSignature",
                          "allowedSignatureTypes": [
                            {
                              "signatureType": "PluginSignature",
                              "pluginId": "ArubaGsp"
                            }
                          ],
                          "id": "sig1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - String": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "StringType",
                            "value": "Default text",
                            "password": false,
                            "multiline": false,
                            "maxLength": 100
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Date": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "DateType",
                            "value": "2025-12-31",
                            "format": "dd.MM.yyyy",
                            "minValue": "2025-01-01",
                            "maxValue": "2026-12-31"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Number": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "NumberType",
                            "value": 42.51,
                            "thousandsSeparator": "Point",
                            "decimalSeparator": "Comma",
                            "symbol": {
                              "value": "€",
                              "position": "Start"
                            },
                            "decimalPlaces": 2,
                            "minValue": 10.25,
                            "maxValue": 1000.78
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - PhoneNumber": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "PhoneNumberType",
                            "value": "+393331234567",
                            "format": "InternationalLeadingPlus"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "TextInput - Time": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "TextInput",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "textInputConfig": {
                            "textInputType": "TimeType",
                            "value": "14:30:00",
                            "format": "HH:mm",
                            "minValue": "08:00:00",
                            "maxValue": "18:00:00"
                          },
                          "readOnly": false,
                          "required": true,
                          "positionX": 50,
                          "positionY": 100,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "txt1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Checkbox": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Checkbox",
                          "checked": true,
                          "value": "yes",
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 300,
                          "width": 20,
                          "height": 20,
                          "page": 1,
                          "id": "chk1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "RadioButton": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "RadioButton",
                          "groupName": "group1",
                          "checked": false,
                          "readOnly": false,
                          "value": "option1",
                          "required": false,
                          "positionX": 100,
                          "positionY": 200,
                          "width": 20,
                          "height": 20,
                          "page": 1,
                          "id": "rb1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "DropDown": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "DropDown",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "options": [
                            {
                              "key": "val1",
                              "value": "Label 1",
                              "selected": false
                            },
                            {
                              "key": "val2",
                              "value": "Label 2",
                              "selected": true
                            }
                          ],
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 400,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "dd1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "ListBox": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "ListBox",
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "options": [
                            {
                              "key": "val1",
                              "value": "Label 1",
                              "selected": false
                            },
                            {
                              "key": "val2",
                              "value": "Label 2",
                              "selected": true
                            }
                          ],
                          "multiselect": true,
                          "readOnly": false,
                          "required": false,
                          "positionX": 50,
                          "positionY": 500,
                          "width": 150,
                          "height": 80,
                          "page": 1,
                          "id": "lb1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Attachment": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Attachment",
                          "required": false,
                          "positionX": 50,
                          "positionY": 600,
                          "width": 100,
                          "height": 30,
                          "page": 1,
                          "id": "att1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Text": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Text",
                            "value": "Default text"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Date": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Date",
                            "format": "dd.MM.yyyy"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - FullName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "FullName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - FirstName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "FirstName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - LastName": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "LastName"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Initials": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Initials"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Annotation - Email": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Annotation",
                          "annotationConfig": {
                            "annotationType": "Email"
                          },
                          "font": {
                            "size": 12,
                            "name": "Arial",
                            "color": "#000000",
                            "align": "Left",
                            "italic": false,
                            "bold": false
                          },
                          "elementName": "AnnotationField_1",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 30,
                          "page": 1,
                          "id": "ann1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Link": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Link",
                          "reference": "https://example.com",
                          "positionX": 50,
                          "positionY": 700,
                          "width": 150,
                          "height": 30,
                          "page": 1,
                          "id": "lnk1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "FileReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "FileReadConfirmation",
                          "required": false,
                          "id": "frc1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "PageReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "PageReadConfirmation",
                          "required": false,
                          "page": 1,
                          "id": "prc1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "AreaReadConfirmation": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "AreaReadConfirmation",
                          "required": false,
                          "positionX": 50,
                          "positionY": 250,
                          "width": 200,
                          "height": 100,
                          "page": 1,
                          "id": "arc1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                },
                "Approval": {
                  "value": {
                    "tasks": [
                      {
                        "field": {
                          "fieldType": "Approval",
                          "required": false,
                          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                          "positionX": 100,
                          "positionY": 200,
                          "width": 200,
                          "height": 50,
                          "page": 1,
                          "id": "app1"
                        },
                        "recipientId": null,
                        "sortOrder": 1
                      }
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/stages": {
      "get": {
        "tags": [
          "Template Stage"
        ],
        "summary": "List template stages",
        "description": "Returns the stages of the specified template.",
        "operationId": "listTemplateStages",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateStageListResponse"
                },
                "example": {
                  "stages": [
                    {
                      "id": "00000000-0000-0000-0000-000000000010",
                      "name": "Stage 1",
                      "sortOrder": 1,
                      "requiredRecipientCompletions": 1,
                      "type": "Signer"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Template Stage"
        ],
        "summary": "Create template stage",
        "description": "Creates a new stage for the specified template.",
        "operationId": "createTemplateStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTemplateStageRequest"
              },
              "examples": {
                "Signer": {
                  "value": {
                    "type": "Signer",
                    "name": "Signer Stage",
                    "requiredRecipientCompletions": 1
                  }
                },
                "CarbonCopy": {
                  "value": {
                    "type": "CarbonCopy",
                    "name": "CarbonCopy Stage"
                  }
                },
                "Viewer": {
                  "value": {
                    "type": "Viewer",
                    "name": "Viewer Stage",
                    "requiredRecipientCompletions": 1
                  }
                },
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "name": "Automatic Stage"
                  }
                },
                "Approver": {
                  "value": {
                    "type": "Approver",
                    "name": "Approver Stage",
                    "requiredRecipientCompletions": 1
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateTemplateStageResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000010"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "Template Stage"
        ],
        "summary": "Reorder template stages",
        "description": "Reorders the stages of the specified template.",
        "operationId": "reorderTemplateStages",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchTemplateStagesRequest"
              },
              "example": {
                "stages": [
                  {
                    "id": "00000000-0000-0000-0000-000000000001",
                    "sortOrder": 1
                  },
                  {
                    "id": "00000000-0000-0000-0000-000000000002",
                    "sortOrder": 2
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/stages/{stageId}": {
      "get": {
        "tags": [
          "Template Stage"
        ],
        "summary": "Get template stage",
        "description": "Returns a specific template stage.",
        "operationId": "getTemplateStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateStageResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000010",
                  "name": "Stage 1",
                  "sortOrder": 1,
                  "requiredRecipientCompletions": 1,
                  "type": "Signer",
                  "recipients": [
                    {
                      "type": "Standard",
                      "givenName": "Mario",
                      "surname": "Rossi",
                      "email": "mario.rossi@example.com",
                      "phoneNumber": "+39123456789",
                      "notificationChannels": [
                        "Email"
                      ],
                      "id": "00000000-0000-0000-0000-000000000100"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Template Stage"
        ],
        "summary": "Update template stage",
        "description": "Updates a specific template stage.",
        "operationId": "updateTemplateStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTemplateStageRequest"
              },
              "examples": {
                "Signer": {
                  "value": {
                    "name": "Signer Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Signer"
                  }
                },
                "CarbonCopy": {
                  "value": {
                    "name": "CarbonCopy Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "CarbonCopy"
                  }
                },
                "Viewer": {
                  "value": {
                    "name": "Viewer Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Viewer"
                  }
                },
                "Automatic": {
                  "value": {
                    "name": "Automatic Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Automatic"
                  }
                },
                "Approver": {
                  "value": {
                    "name": "Approver Stage",
                    "requiredRecipientCompletions": 1,
                    "type": "Approver"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Template Stage"
        ],
        "summary": "Delete template stage",
        "description": "Deletes a specific template stage.",
        "operationId": "deleteTemplateStage",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/stages/{stageId}/recipients": {
      "post": {
        "tags": [
          "Template Stage Recipient"
        ],
        "summary": "Create template stage recipient",
        "description": "Creates a new recipient for the specified template stage.",
        "operationId": "createTemplateStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/CreateTemplateAutomaticRecipientRequest"
                  },
                  {
                    "$ref": "#/components/schemas/CreateTemplateStandardRecipientRequest"
                  }
                ],
                "description": "Base record for create template recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
              },
              "examples": {
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "signatureProfile": "default-eseal-profile",
                    "signatureReason": "I agree to the terms.",
                    "languageCode": "en"
                  }
                },
                "Standard - No authentication": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OTP SMS": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oneTimePassword": {
                        "channel": "Sms"
                      }
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Access code": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "accessCode": {
                        "code": "1234"
                      }
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OAuth": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oAuthAuthentications": [
                        {
                          "providerName": "google",
                          "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                        }
                      ]
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Disposable certificate": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "signatureConfiguration": {
                      "disposableCertificate": {
                        "document": {
                          "type": "IdentityCard",
                          "number": "AA1234567",
                          "serialNumber": "SN-0001",
                          "issuingCountry": "IT",
                          "issuedBy": "Comune di Roma",
                          "issuedOn": "2020-01-15T00:00:00+00:00",
                          "expiresAt": "2030-01-15T00:00:00+00:00"
                        },
                        "identification": {
                          "type": "NationalIdentityCard",
                          "issuingCountry": "IT"
                        },
                        "verificationPhoneNumber": "+39123456789"
                      }
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateTemplateRecipientResponse"
                },
                "example": {
                  "id": "00000000-0000-0000-0000-000000000100"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/templates/{templateId}/stages/{stageId}/recipients/{recipientId}": {
      "get": {
        "tags": [
          "Template Stage Recipient"
        ],
        "summary": "Get template stage recipient",
        "description": "Returns a specific template stage recipient.",
        "operationId": "getTemplateStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/TemplateStandardRecipientResponse"
                    },
                    {
                      "$ref": "#/components/schemas/TemplateAutomaticRecipientResponse"
                    }
                  ],
                  "description": "Detailed representation of a recipient. Base for polymorphic response."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Template Stage Recipient"
        ],
        "summary": "Update template stage recipient",
        "description": "Updates a specific template stage recipient.",
        "operationId": "updateTemplateStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/UpdateTemplateAutomaticRecipientRequest"
                  },
                  {
                    "$ref": "#/components/schemas/UpdateTemplateStandardRecipientRequest"
                  }
                ],
                "description": "Base record for update template recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
              },
              "examples": {
                "Automatic": {
                  "value": {
                    "type": "Automatic",
                    "signatureProfile": "default-eseal-profile",
                    "signatureReason": "I agree to the terms.",
                    "languageCode": "en"
                  }
                },
                "Standard - No authentication": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OTP SMS": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oneTimePassword": {
                        "channel": "Sms"
                      }
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Access code": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "accessCode": {
                        "code": "1234"
                      }
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - OAuth": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "authentication": {
                      "oAuthAuthentications": [
                        {
                          "providerName": "google",
                          "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
                        }
                      ]
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                },
                "Standard - Disposable certificate": {
                  "value": {
                    "type": "Standard",
                    "givenName": "Mario",
                    "surname": "Rossi",
                    "email": "mario.rossi@example.com",
                    "phoneNumber": "+39123456789",
                    "notificationChannels": [
                      "Email"
                    ],
                    "signatureConfiguration": {
                      "disposableCertificate": {
                        "document": {
                          "type": "IdentityCard",
                          "number": "AA1234567",
                          "serialNumber": "SN-0001",
                          "issuingCountry": "IT",
                          "issuedBy": "Comune di Roma",
                          "issuedOn": "2020-01-15T00:00:00+00:00",
                          "expiresAt": "2030-01-15T00:00:00+00:00"
                        },
                        "identification": {
                          "type": "NationalIdentityCard",
                          "issuingCountry": "IT"
                        },
                        "verificationPhoneNumber": "+39123456789"
                      }
                    },
                    "personalMessage": "Please review and sign the attached document.",
                    "signatureReason": "I agree to the terms.",
                    "isSignatureReasonEditable": false,
                    "languageCode": "en"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Template Stage Recipient"
        ],
        "summary": "Delete template stage recipient",
        "description": "Deletes a specific template stage recipient.",
        "operationId": "deleteTemplateStageRecipient",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/templateId"
          },
          {
            "$ref": "#/components/parameters/stageId"
          },
          {
            "$ref": "#/components/parameters/recipientId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/users": {
      "get": {
        "tags": [
          "User"
        ],
        "summary": "List users",
        "description": "Returns a paginated list of users within the specified organization.",
        "operationId": "listUsers",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "SearchText",
            "in": "query",
            "description": "Filter users by a free-text search across given name, surname, and email.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "GivenName",
            "in": "query",
            "description": "Filter users by given name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Surname",
            "in": "query",
            "description": "Filter users by surname.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Email",
            "in": "query",
            "description": "Filter users by email address.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "SortingKey",
            "in": "query",
            "description": "The sorting key.",
            "schema": {
              "$ref": "#/components/schemas/UserSortingKey"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Whether to sort in ascending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "User"
        ],
        "summary": "Create user",
        "description": "Creates a new user within the specified organization.",
        "operationId": "createUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserRequest"
              },
              "example": {
                "givenName": "Mario",
                "surname": "Rossi",
                "email": "mario.rossi@example.com",
                "regionalSettings": {
                  "timeZone": "Europe/Berlin",
                  "dateTimeFormat": "dd/MM/yyyy | HH:mm",
                  "language": "it",
                  "country": "IT"
                },
                "phoneNumber": "+39021234567"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateUserResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/users/{userId}": {
      "get": {
        "tags": [
          "User"
        ],
        "summary": "Get user",
        "description": "Returns a specific user",
        "operationId": "getUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "User"
        ],
        "summary": "Update user",
        "description": "Updates a specific user.",
        "operationId": "updateUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserRequest"
              },
              "example": {
                "givenName": "Mario",
                "surname": "Rossi",
                "regionalSettings": {
                  "timeZone": "Europe/Berlin",
                  "dateTimeFormat": "dd/MM/yyyy | HH:mm",
                  "language": "it",
                  "country": "IT"
                },
                "phoneNumber": "+39021234567"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "User"
        ],
        "summary": "Delete user",
        "description": "Deletes a user within the specified organization.",
        "operationId": "deleteUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/users/{userId}/application-roles": {
      "put": {
        "tags": [
          "User"
        ],
        "summary": "Update user application roles",
        "description": "Replaces the full set of application roles assigned to a user within the specified organization.",
        "operationId": "updateUserApplicationRoles",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserApplicationRolesRequest"
              },
              "example": {
                "applicationRoles": [
                  {
                    "id": "550e8400-e29b-41d4-a716-446655440000"
                  },
                  {
                    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups": {
      "get": {
        "tags": [
          "User Group"
        ],
        "summary": "List user groups",
        "description": "Returns a paginated list of user groups for the specified organization.",
        "operationId": "listUserGroups",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "SearchText",
            "in": "query",
            "description": "Optional free-text filter.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortingKey",
            "in": "query",
            "description": "Optional sorting key.",
            "schema": {
              "$ref": "#/components/schemas/UserGroupsSortingKey"
            }
          },
          {
            "name": "Ascending",
            "in": "query",
            "description": "Optional sort direction.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupListResponse"
                },
                "example": {
                  "userGroups": [
                    {
                      "id": "92b18930-7fef-43c9-8c32-39e4adb112e7",
                      "name": "Sales Team"
                    },
                    {
                      "id": "2546d916-ae17-40fc-8c36-5eec748bd923",
                      "name": "Legal Team"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 10,
                    "totalCount": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "User Group"
        ],
        "summary": "Create user group",
        "description": "Creates a new user group with the specified name.",
        "operationId": "createUserGroup",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserGroupRequest"
              },
              "example": {
                "name": "Sales Team"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateUserGroupResponse"
                },
                "example": {
                  "id": "99d90989-2e22-40a3-ad81-bfb8636ee01b"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups/{userGroupId}": {
      "put": {
        "tags": [
          "User Group"
        ],
        "summary": "Update user group",
        "description": "Replaces the name of the specified user group.",
        "operationId": "updateUserGroup",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserGroupRequest"
              },
              "example": {
                "name": "Sales Team"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "User Group"
        ],
        "summary": "Delete user group",
        "description": "Deletes the specified user group.",
        "operationId": "deleteUserGroup",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups/{userGroupId}/contact-custom-fields": {
      "get": {
        "tags": [
          "User Group"
        ],
        "summary": "Lists the custom fields defined for the contacts of a group.",
        "description": "Returns the custom fields defined for the contacts of the group. Use their ids to read the custom field values of a contact.",
        "operationId": "listGroupContactCustomFields",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupContactCustomFieldListResponse"
                },
                "example": {
                  "customFields": [
                    {
                      "id": "400658ab-5f75-43c3-aff1-1ca6a046d9fa",
                      "name": "Tax code"
                    },
                    {
                      "id": "512a272d-515b-4413-a8e0-4805e795da50",
                      "name": "Department"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups/{userGroupId}/users": {
      "get": {
        "tags": [
          "User Group"
        ],
        "summary": "Lists users in a group.",
        "description": "Returns a paginated list of users in the group.",
        "operationId": "listUserGroupUsers",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupUserListResponse"
                },
                "example": {
                  "users": [
                    {
                      "id": "c2d3e4f5-a6b7-48c9-b0c1-d2e3f4a5b6c7",
                      "email": "alice@example.com",
                      "givenName": "Alice",
                      "surname": "Johnson"
                    },
                    {
                      "id": "d4e5f6a7-b8c9-4a0b-c1d2-e3f4a5b6c7d8",
                      "email": "bob@example.com",
                      "givenName": "Bob",
                      "surname": "Smith"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 10,
                    "totalCount": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "User Group"
        ],
        "summary": "Adds a user to a group.",
        "description": "Adds a user to the group with optional permissions and business role.",
        "operationId": "addUserToGroup",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          }
        ],
        "requestBody": {
          "description": "Request containing user ID and optional permissions/role.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddUserToGroupRequest"
              },
              "example": {
                "userId": "c2d3e4f5-a6b7-48c9-b0c1-d2e3f4a5b6c7",
                "permissions": {
                  "users": {
                    "read": true,
                    "createUpdateDelete": false
                  },
                  "envelopes": {
                    "share": true,
                    "manage": false
                  },
                  "templates": {
                    "share": true,
                    "manage": false
                  },
                  "contacts": {
                    "read": true,
                    "createUpdateDelete": false,
                    "customize": false
                  }
                },
                "businessRoleId": "43f3e4f5-a6b7-48c9-b0c1-d2e3f4a5b6c7"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups/{userGroupId}/users/{userId}": {
      "get": {
        "tags": [
          "User Group"
        ],
        "summary": "Gets details about a specific user in a group.",
        "description": "Returns details about a specific user in the group.",
        "operationId": "getGroupUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "$ref": "#/components/parameters/userId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupUserResponse"
                },
                "example": {
                  "id": "a7b8c9d0-e1f2-4a5b-8c6d-7e8f9a0b1c2d",
                  "permissions": {
                    "users": {
                      "read": true,
                      "createUpdateDelete": false
                    },
                    "envelopes": {
                      "share": true,
                      "manage": false
                    },
                    "templates": {
                      "share": true,
                      "manage": false
                    },
                    "contacts": {
                      "read": true,
                      "createUpdateDelete": false,
                      "customize": false
                    }
                  },
                  "businessRoleId": "f3a4b5c6-d7e8-49f0-a1b2-c3d4e5f6a7b8"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "patch": {
        "tags": [
          "User Group"
        ],
        "summary": "Updates a user's permissions and/or business role in a group.",
        "description": "Updates a user's permissions and/or business role in the group.",
        "operationId": "updateGroupUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "$ref": "#/components/parameters/userId"
          }
        ],
        "requestBody": {
          "description": "Request containing optional permissions and/or business role to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserGroupUserRequest"
              },
              "example": {
                "permissions": {
                  "users": {
                    "read": true,
                    "createUpdateDelete": false
                  },
                  "envelopes": {
                    "share": true,
                    "manage": false
                  },
                  "templates": {
                    "share": true,
                    "manage": false
                  },
                  "contacts": {
                    "read": true,
                    "createUpdateDelete": false,
                    "customize": false
                  }
                },
                "businessRoleId": "c2d3e4f5-a6b7-48c9-b0c1-d2e3f4a5b6c7"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "User Group"
        ],
        "summary": "Removes a user from a group.",
        "description": "Removes a user from the group.",
        "operationId": "deleteGroupUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "$ref": "#/components/parameters/userId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups/{userGroupId}/contacts": {
      "get": {
        "tags": [
          "User Group"
        ],
        "summary": "Lists the contacts shared in a group.",
        "description": "Returns a paginated list of the contacts shared in the group, including their custom field values.",
        "operationId": "listGroupContacts",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "Page",
            "in": "query",
            "description": "The page number.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "description": "The number of items per page.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupContactListResponse"
                },
                "example": {
                  "contacts": [
                    {
                      "id": "e201ace1-7752-4a33-a9b3-2a46902e8de3",
                      "email": "john.smith@example.com",
                      "givenName": "John",
                      "surname": "Smith",
                      "phoneNumber": "+44 20 7946 0958",
                      "language": "en",
                      "Tax code": "AB123456C",
                      "Department": "Administration"
                    },
                    {
                      "id": "34729a5f-71b6-4206-aa8f-eb2ef9c06257",
                      "email": "emily.clarke@example.com",
                      "givenName": "Emily",
                      "surname": "Clarke",
                      "phoneNumber": "+44 161 496 0123",
                      "language": "en",
                      "Tax code": "CD987654A",
                      "Department": "Purchasing"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "pageSize": 10,
                    "totalCount": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "User Group"
        ],
        "summary": "Creates a contact in a group.",
        "description": "Creates a contact in the group. The values of the group's custom fields are sent as additional properties next to the standard fields, keyed by custom field name; a property that is neither a standard field nor a custom field of the group is rejected with 422, a property sent more than once with 400.",
        "operationId": "createGroupContact",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserGroupContactRequest"
              },
              "examples": {
                "standard fields only": {
                  "value": {
                    "givenName": "John",
                    "surname": "Smith",
                    "email": "john.smith@example.com",
                    "phoneNumber": "+44 20 7946 0958",
                    "language": "en"
                  }
                },
                "with custom fields": {
                  "value": {
                    "givenName": "John",
                    "surname": "Smith",
                    "email": "john.smith@example.com",
                    "phoneNumber": "+44 20 7946 0958",
                    "language": "en",
                    "Tax code": "AB123456C",
                    "Department": "Administration"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateUserGroupContactResponse"
                },
                "example": {
                  "id": "e201ace1-7752-4a33-a9b3-2a46902e8de3"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups/{userGroupId}/contacts/{contactId}": {
      "get": {
        "tags": [
          "User Group"
        ],
        "summary": "Gets a single contact shared in a group.",
        "description": "Returns a single contact shared in the group, including its custom field values.",
        "operationId": "getGroupContact",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "contactId",
            "in": "path",
            "description": "Unique identifier of the contact.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupContactSummary"
                },
                "example": {
                  "id": "e201ace1-7752-4a33-a9b3-2a46902e8de3",
                  "email": "john.smith@example.com",
                  "givenName": "John",
                  "surname": "Smith",
                  "phoneNumber": "+44 20 7946 0958",
                  "language": "en",
                  "Tax code": "AB123456C",
                  "Department": "Administration"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "User Group"
        ],
        "summary": "Replaces a contact of a group.",
        "description": "Replaces a contact of the group as a whole: a standard field or a custom field that is not sent is cleared. The values of the group's custom fields are sent as additional properties next to the standard fields, keyed by custom field name; a property that is neither a standard field nor a custom field of the group is rejected with 422, a property sent more than once with 400.",
        "operationId": "updateGroupContact",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "contactId",
            "in": "path",
            "description": "Unique identifier of the contact.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserGroupContactRequest"
              },
              "examples": {
                "standard fields only": {
                  "value": {
                    "givenName": "John",
                    "surname": "Smith",
                    "email": "john.smith@example.com",
                    "phoneNumber": "+44 20 7946 0958",
                    "language": "en"
                  }
                },
                "with custom fields": {
                  "value": {
                    "givenName": "John",
                    "surname": "Smith",
                    "email": "john.smith@example.com",
                    "phoneNumber": "+44 20 7946 0958",
                    "language": "en",
                    "Tax code": "AB123456C",
                    "Department": "Administration"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "User Group"
        ],
        "summary": "Deletes a contact from a group.",
        "description": "Deletes a contact from the group.",
        "operationId": "deleteGroupContact",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "contactId",
            "in": "path",
            "description": "Unique identifier of the contact.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/user-groups/{userGroupId}/contact-custom-fields/{fieldId}": {
      "get": {
        "tags": [
          "User Group"
        ],
        "summary": "Gets a custom field defined for the contacts of a group.",
        "description": "Returns the custom field identified by fieldId.",
        "operationId": "getGroupContactCustomField",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "fieldId",
            "in": "path",
            "description": "Unique identifier of the contact custom field.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserGroupContactCustomFieldSummary"
                },
                "example": {
                  "id": "400658ab-5f75-43c3-aff1-1ca6a046d9fa",
                  "name": "Tax code"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "User Group"
        ],
        "summary": "Updates the name of a custom field defined for the contacts of a group.",
        "description": "Replaces the name of the custom field identified by fieldId.",
        "operationId": "updateGroupContactCustomField",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "fieldId",
            "in": "path",
            "description": "Unique identifier of the contact custom field.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "description": "The replacement custom field name.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserGroupContactCustomFieldRequest"
              },
              "example": {
                "name": "Tax code"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "User Group"
        ],
        "summary": "Deletes a custom field defined for the contacts of a group.",
        "description": "Deletes the custom field identified by fieldId.",
        "operationId": "deleteGroupContactCustomField",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/userGroupId"
          },
          {
            "name": "fieldId",
            "in": "path",
            "description": "Unique identifier of the contact custom field.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhooks": {
      "get": {
        "tags": [
          "Webhook"
        ],
        "summary": "List envelope webhooks",
        "description": "Returns the webhooks of the specified envelope.",
        "operationId": "listEnvelopeWebhooks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeWebhookListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Webhook"
        ],
        "summary": "Create envelope webhook",
        "description": "Creates a new webhook for the specified envelope.",
        "operationId": "createEnvelopeWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEnvelopeWebhookRequest"
              },
              "examples": {
                "without authentication": {
                  "value": {
                    "url": "https://example.com/hooks/envelope",
                    "event": "EnvelopeCompleted"
                  }
                },
                "with header authentication": {
                  "value": {
                    "url": "https://example.com/hooks/envelope",
                    "event": "EnvelopeCompleted",
                    "authentication": {
                      "headers": {
                        "Authorization": "Bearer token_123"
                      }
                    }
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateEnvelopeWebhookResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhooks/{webhookId}": {
      "get": {
        "tags": [
          "Webhook"
        ],
        "summary": "Get envelope webhook",
        "description": "Returns a specific envelope webhook.",
        "operationId": "getEnvelopeWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/webhookId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeWebhookResponse"
                },
                "example": {
                  "id": "b1f2c3d4-e5f6-7890-abcd-ef1234567890",
                  "url": "https://example.com/hooks/envelope",
                  "event": "EnvelopeCompleted",
                  "createdAt": "2026-10-05T10:30:00+00:00",
                  "updatedAt": "2026-10-05T10:30:00+00:00",
                  "authentication": {
                    "headers": {
                      "Authorization": "*****"
                    },
                    "clientCertificate": null,
                    "clientKey": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Webhook"
        ],
        "summary": "Update envelope webhook",
        "description": "Replaces a specific envelope webhook.",
        "operationId": "updateEnvelopeWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/webhookId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEnvelopeWebhookRequest"
              },
              "example": {
                "url": "https://example.com/hooks/envelope-new",
                "event": "EnvelopeCompleted",
                "authentication": {
                  "headers": {
                    "Authorization": "Bearer token_123"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Webhook"
        ],
        "summary": "Delete envelope webhook",
        "description": "Deletes a specific envelope webhook.",
        "operationId": "deleteEnvelopeWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          },
          {
            "$ref": "#/components/parameters/webhookId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhook-subscription": {
      "get": {
        "tags": [
          "Webhook"
        ],
        "summary": "Get webhook subscription (deprecated)",
        "description": "DEPRECATED: this endpoint will be removed on 31 October 2026. Use the envelope webhooks endpoints ({envelopeId}/webhooks) instead. Returns the webhook subscription for the specified envelope.",
        "operationId": "getWebhookSubscription",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookSubscriptionResponse"
                },
                "example": {
                  "id": "11111111-1111-1111-1111-111111111111",
                  "url": "https://hook.example.com",
                  "hasHeaders": false,
                  "hasClientCertificate": false,
                  "createdAt": "2026-11-11T14:00:03.4952172+00:00"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "deprecated": true
      },
      "post": {
        "tags": [
          "Webhook"
        ],
        "summary": "Create webhook subscription (deprecated)",
        "description": "DEPRECATED: this endpoint will be removed on 31 October 2026. Use the envelope webhooks endpoints ({envelopeId}/webhooks) instead. Creates a webhook subscription for the specified envelope.",
        "operationId": "createWebhookSubscription",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookSubscriptionRequest"
              },
              "example": {
                "url": "https://hook.example.com"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookSubscriptionResponse"
                },
                "example": {
                  "id": "11111111-1111-1111-1111-111111111111",
                  "url": "https://hook.example.com",
                  "hasHeaders": false,
                  "hasClientCertificate": false,
                  "createdAt": "2026-11-11T14:00:03.4970766+00:00"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "deprecated": true
      },
      "delete": {
        "tags": [
          "Webhook"
        ],
        "summary": "Delete webhook subscription (deprecated)",
        "description": "DEPRECATED: this endpoint will be removed on 31 October 2026. Use the envelope webhooks endpoints ({envelopeId}/webhooks) instead. Deletes the webhook subscription for the specified envelope.",
        "operationId": "deleteWebhookSubscription",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/envelopeId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "deprecated": true
      }
    },
    "/api/v1/organizations/{organizationId}/webhooks": {
      "get": {
        "tags": [
          "Webhook"
        ],
        "summary": "List organization webhooks",
        "description": "Returns the webhooks of the specified organization.",
        "operationId": "listOrganizationWebhooks",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationWebhookListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "post": {
        "tags": [
          "Webhook"
        ],
        "summary": "Create organization webhook",
        "description": "Creates a new webhook for the specified organization. Only the EnvelopeCompleted event is supported.",
        "operationId": "createOrganizationWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateOrganizationWebhookRequest"
              },
              "examples": {
                "without authentication": {
                  "value": {
                    "url": "https://example.com/hooks/organization",
                    "event": "EnvelopeCompleted"
                  }
                },
                "with header authentication": {
                  "value": {
                    "url": "https://example.com/hooks/organization",
                    "event": "EnvelopeCompleted",
                    "authentication": {
                      "headers": {
                        "Authorization": "Bearer token_123"
                      }
                    }
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateOrganizationWebhookResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/api/v1/organizations/{organizationId}/webhooks/{webhookId}": {
      "get": {
        "tags": [
          "Webhook"
        ],
        "summary": "Get organization webhook",
        "description": "Returns a specific organization webhook.",
        "operationId": "getOrganizationWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/webhookId"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationWebhookResponse"
                },
                "example": {
                  "id": "c2a3b4d5-e6f7-4890-abcd-ef1234567890",
                  "url": "https://example.com/hooks/organization",
                  "event": "EnvelopeCompleted",
                  "createdAt": "2026-10-05T10:30:00+00:00",
                  "updatedAt": "2026-10-05T10:30:00+00:00",
                  "authentication": {
                    "headers": {
                      "Authorization": "*****"
                    },
                    "clientCertificate": null,
                    "clientKey": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "put": {
        "tags": [
          "Webhook"
        ],
        "summary": "Update organization webhook",
        "description": "Replaces a specific organization webhook. Only the EnvelopeCompleted event is supported.",
        "operationId": "updateOrganizationWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/webhookId"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateOrganizationWebhookRequest"
              },
              "example": {
                "url": "https://example.com/hooks/organization-new",
                "event": "EnvelopeCompleted",
                "authentication": {
                  "headers": {
                    "Authorization": "Bearer token_123"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      },
      "delete": {
        "tags": [
          "Webhook"
        ],
        "summary": "Delete organization webhook",
        "description": "Deletes a specific organization webhook.",
        "operationId": "deleteOrganizationWebhook",
        "parameters": [
          {
            "$ref": "#/components/parameters/organizationId"
          },
          {
            "$ref": "#/components/parameters/webhookId"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Unprocessable Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorsResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AbsoluteBulkEnvelopeExpirationResponse": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration."
      },
      "AbsoluteCreateBulkEnvelopeExpiration": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration."
      },
      "AbsoluteCreateEnvelopeExpiration": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration.",
        "example": {
          "expiresAt": "2026-12-11T14:00:03.1736798+00:00",
          "mode": "Absolute"
        }
      },
      "AbsoluteCreateTemplateExpiration": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration.",
        "example": {
          "expiresAt": "2026-12-11T14:00:03.3549182+00:00",
          "mode": "Absolute"
        }
      },
      "AbsoluteEnvelopeExpirationResponse": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration."
      },
      "AbsoluteTemplateExpirationResponse": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration."
      },
      "AbsoluteUpdateBulkEnvelopeExpirationRequest": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration."
      },
      "AbsoluteUpdateEnvelopeExpirationRequest": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration.",
        "example": {
          "expiresAt": "2026-12-11T14:00:03.1819007+00:00",
          "mode": "Absolute"
        }
      },
      "AbsoluteUpdateTemplateExpirationRequest": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "expiresAt": {
            "type": "string",
            "description": "The exact expiration date and time.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-12-31T23:59:59Z"
          },
          "mode": {
            "enum": [
              "Absolute"
            ],
            "type": "string",
            "default": "Absolute"
          }
        },
        "additionalProperties": false,
        "description": "Absolute expiration configuration.",
        "example": {
          "expiresAt": "2026-12-11T14:00:03.3640648+00:00",
          "mode": "Absolute"
        }
      },
      "AccessCode": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The access code.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Access code configuration."
      },
      "AddEnvelopeStageConfigurationActionRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyActionRequest"
          },
          {
            "required": [
              "recipientSource",
              "stage"
            ],
            "type": "object",
            "properties": {
              "stage": {
                "$ref": "#/components/schemas/StageConfigurationRequest"
              },
              "recipientSource": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/StaticPolicyRecipientSourceRequest"
                  },
                  {
                    "$ref": "#/components/schemas/DynamicPolicyRecipientSourceRequest"
                  },
                  {
                    "enum": [
                      null
                    ],
                    "nullable": true
                  }
                ],
                "description": "The action's recipient source, discriminated by the `type` property."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "AddEnvelopeStageConfiguration"
            ],
            "type": "string",
            "default": "AddEnvelopeStageConfiguration"
          }
        },
        "description": "Adds a stage configuration to the envelope."
      },
      "AddUserGroupContactsPermissionRequest": {
        "type": "object",
        "properties": {
          "read": {
            "type": "boolean",
            "description": "Whether the user has permission to read contacts.",
            "nullable": true
          },
          "createUpdateDelete": {
            "type": "boolean",
            "description": "Whether the user has permission to create, update, and delete contacts.",
            "nullable": true
          },
          "customize": {
            "type": "boolean",
            "description": "Whether the user has permission to customize contacts.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Contacts management permissions."
      },
      "AddUserGroupEnvelopesPermissionRequest": {
        "type": "object",
        "properties": {
          "share": {
            "type": "boolean",
            "description": "Whether the user has permission to share envelopes.",
            "nullable": true
          },
          "manage": {
            "type": "boolean",
            "description": "Whether the user has permission to manage envelopes.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Envelopes management permissions."
      },
      "AddUserGroupPermissionRequest": {
        "type": "object",
        "properties": {
          "users": {
            "$ref": "#/components/schemas/AddUserGroupUsersPermissionRequest"
          },
          "envelopes": {
            "$ref": "#/components/schemas/AddUserGroupEnvelopesPermissionRequest"
          },
          "templates": {
            "$ref": "#/components/schemas/AddUserGroupTemplatesPermissionRequest"
          },
          "contacts": {
            "$ref": "#/components/schemas/AddUserGroupContactsPermissionRequest"
          }
        },
        "additionalProperties": false,
        "description": "Permissions for a user in a group."
      },
      "AddUserGroupTemplatesPermissionRequest": {
        "type": "object",
        "properties": {
          "share": {
            "type": "boolean",
            "description": "Whether the user has permission to share templates.",
            "nullable": true
          },
          "manage": {
            "type": "boolean",
            "description": "Whether the user has permission to manage templates.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Templates management permissions."
      },
      "AddUserGroupUsersPermissionRequest": {
        "type": "object",
        "properties": {
          "read": {
            "type": "boolean",
            "description": "Whether the user has permission to read users.",
            "nullable": true
          },
          "createUpdateDelete": {
            "type": "boolean",
            "description": "Whether the user has permission to create, update, and delete users.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Users management permissions."
      },
      "AddUserToGroupRequest": {
        "required": [
          "userId"
        ],
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "description": "The ID of the user to add.",
            "format": "uuid"
          },
          "permissions": {
            "$ref": "#/components/schemas/AddUserGroupPermissionRequest"
          },
          "businessRoleId": {
            "type": "string",
            "description": "Optional business role to assign to the user.",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request to add a user to a group."
      },
      "Agreement": {
        "required": [
          "body",
          "language"
        ],
        "type": "object",
        "properties": {
          "language": {
            "type": "string",
            "description": "The BCP-47 language code for this agreement.",
            "example": "en"
          },
          "title": {
            "type": "string",
            "description": "The agreement title, or null when not set.",
            "nullable": true,
            "example": "Please review the agreement"
          },
          "body": {
            "type": "string",
            "description": "The agreement body.",
            "example": "Please read and accept the agreement."
          }
        },
        "additionalProperties": false,
        "description": "A single agreement configuration for a specific language."
      },
      "AgreementSettings": {
        "required": [
          "agreements",
          "enabled",
          "overridable"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether the standard agreement text applies to all envelopes sent by the organization."
          },
          "overridable": {
            "type": "boolean",
            "description": "Whether senders are allowed to override the standard agreement text at envelope or template level."
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The configured agreement texts, one per organization-enabled language."
          }
        },
        "additionalProperties": false,
        "description": "The organization's envelope agreement configuration."
      },
      "AnnotationField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "required": [
              "annotationConfig"
            ],
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "annotationConfig": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/FullNameAnnotationValueFormat"
                  },
                  {
                    "$ref": "#/components/schemas/FirstNameAnnotationValueFormat"
                  },
                  {
                    "$ref": "#/components/schemas/LastNameAnnotationValueFormat"
                  },
                  {
                    "$ref": "#/components/schemas/InitialsAnnotationValueFormat"
                  },
                  {
                    "$ref": "#/components/schemas/EmailAnnotationValueFormat"
                  },
                  {
                    "$ref": "#/components/schemas/DateAnnotationValueFormat"
                  },
                  {
                    "$ref": "#/components/schemas/TextAnnotationValueFormat"
                  },
                  {
                    "enum": [
                      null
                    ],
                    "nullable": true
                  }
                ],
                "description": "The annotation configuration."
              },
              "font": {
                "$ref": "#/components/schemas/FontStyle"
              },
              "elementName": {
                "type": "string",
                "description": "The name of the element.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "Annotation"
            ],
            "type": "string",
            "default": "Annotation"
          }
        },
        "description": "An annotation field.",
        "example": {
          "fieldType": "Annotation",
          "annotationConfig": {
            "annotationType": "Text"
          },
          "positionX": 100,
          "positionY": 200,
          "width": 200,
          "height": 30,
          "page": 1,
          "id": "ann1"
        }
      },
      "AnnotationType": {
        "enum": [
          "FullName",
          "FirstName",
          "LastName",
          "Initials",
          "Email",
          "Date",
          "Text"
        ],
        "type": "string",
        "description": "Identifies the type of annotation field."
      },
      "ApplicationRoleListResponse": {
        "required": [
          "applicationRoles",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "applicationRoles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApplicationRoleSummary"
            },
            "description": "The list of application roles."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of application roles."
      },
      "ApplicationRoleResponse": {
        "required": [
          "id",
          "isSystemRole",
          "name",
          "permissions"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The application role ID.",
            "format": "uuid",
            "example": "6f2ed3d2-0617-4be4-9445-7e6a4090b260"
          },
          "name": {
            "type": "string",
            "description": "The application role name.",
            "example": "Administrator"
          },
          "description": {
            "type": "string",
            "description": "The application role description.",
            "nullable": true,
            "example": "Can read envelopes"
          },
          "isSystemRole": {
            "type": "boolean",
            "description": "Whether the application role is a built-in system role.",
            "example": false
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "description": "The list of entity/action permission pairs granted by the application role."
          }
        },
        "additionalProperties": false,
        "description": "Response model for an application role's full details."
      },
      "ApplicationRoleSortingKey": {
        "enum": [
          "Id",
          "Name"
        ],
        "type": "string",
        "description": "The available sorting keys for listing application roles."
      },
      "ApplicationRoleSummary": {
        "required": [
          "id",
          "isSystemRole",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The application role ID.",
            "format": "uuid",
            "example": "6f2ed3d2-0617-4be4-9445-7e6a4090b260"
          },
          "name": {
            "type": "string",
            "description": "The application role name.",
            "example": "Administrator"
          },
          "description": {
            "type": "string",
            "description": "The application role description.",
            "nullable": true,
            "example": "Can read envelopes"
          },
          "isSystemRole": {
            "type": "boolean",
            "description": "Whether the application role is a built-in system role.",
            "example": false
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of an application role."
      },
      "ApprovalField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              },
              "layoutId": {
                "type": "string",
                "description": "The optional identifier of the signature layout applied to this field, one of the organization's signature layouts. When omitted, the organization default layout is used.",
                "format": "uuid",
                "nullable": true,
                "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "Approval"
            ],
            "type": "string",
            "default": "Approval"
          }
        },
        "description": "An approval field.",
        "example": {
          "fieldType": "Approval",
          "required": false,
          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "positionX": 100,
          "positionY": 200,
          "width": 200,
          "height": 50,
          "page": 1,
          "id": "app1"
        }
      },
      "AreaReadConfirmationField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "AreaReadConfirmation"
            ],
            "type": "string",
            "default": "AreaReadConfirmation"
          }
        },
        "description": "An area read confirmation field.",
        "example": {
          "fieldType": "AreaReadConfirmation",
          "required": false,
          "positionX": 50,
          "positionY": 250,
          "width": 200,
          "height": 100,
          "page": 1,
          "id": "arc1"
        }
      },
      "AttachmentField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "Attachment"
            ],
            "type": "string",
            "default": "Attachment"
          }
        },
        "description": "An attachment field.",
        "example": {
          "fieldType": "Attachment",
          "required": false,
          "positionX": 50,
          "positionY": 600,
          "width": 100,
          "height": 30,
          "page": 1,
          "id": "att1"
        }
      },
      "AuditTrailMode": {
        "enum": [
          "Standard",
          "PDF/A-2b"
        ],
        "type": "string",
        "description": "The audit trail generation modes supported by the settings/signature endpoint."
      },
      "AuditTrailModeOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/AuditTrailMode"
          }
        },
        "additionalProperties": false
      },
      "AuthenticationOneTimePassword": {
        "required": [
          "channel"
        ],
        "type": "object",
        "properties": {
          "channel": {
            "$ref": "#/components/schemas/OneTimePasswordAuthenticationChannel"
          }
        },
        "additionalProperties": false,
        "description": "OTP authentication configuration."
      },
      "AutomaticSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "AutomaticSignature"
            ],
            "type": "string",
            "default": "AutomaticSignature"
          }
        },
        "additionalProperties": false,
        "description": "Automatic signature configuration.",
        "example": {
          "signatureType": "AutomaticSignature"
        }
      },
      "BaseField": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The field ID."
          }
        },
        "additionalProperties": false,
        "description": "Base definition of a field on a file page."
      },
      "BiometricSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "BiometricSignature"
            ],
            "type": "string",
            "default": "BiometricSignature"
          }
        },
        "additionalProperties": false,
        "description": "Biometric signature configuration.",
        "example": {
          "signatureType": "BiometricSignature"
        }
      },
      "BooleanOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "type": "boolean",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "BulkEnvelopeChildEnvelopeListResponse": {
        "required": [
          "envelopes",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "envelopes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeChildEnvelopeSummary"
            },
            "description": "The list of child envelopes."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of child envelopes generated by a bulk envelope send."
      },
      "BulkEnvelopeChildEnvelopeSummary": {
        "required": [
          "createdAt",
          "id",
          "name",
          "status",
          "updatedAt"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The envelope ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          },
          "name": {
            "type": "string",
            "description": "The envelope name.",
            "example": "Contract for Mario Rossi"
          },
          "status": {
            "type": "string",
            "description": "The current status of the envelope.",
            "example": "Draft"
          },
          "createdAt": {
            "type": "string",
            "description": "When the envelope was created.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the envelope was last updated.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "sentAt": {
            "type": "string",
            "description": "When the envelope was sent.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-01-02T12:00:00Z"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a child envelope generated by a bulk envelope send."
      },
      "BulkEnvelopeFieldTask": {
        "required": [
          "field",
          "sortOrder",
          "source"
        ],
        "type": "object",
        "properties": {
          "field": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/SignatureField"
              },
              {
                "$ref": "#/components/schemas/TextInputField"
              },
              {
                "$ref": "#/components/schemas/CheckboxField"
              },
              {
                "$ref": "#/components/schemas/DropDownField"
              },
              {
                "$ref": "#/components/schemas/ListBoxField"
              },
              {
                "$ref": "#/components/schemas/AttachmentField"
              },
              {
                "$ref": "#/components/schemas/LinkField"
              },
              {
                "$ref": "#/components/schemas/FileReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/PageReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/AreaReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/ApprovalField"
              },
              {
                "$ref": "#/components/schemas/AnnotationField"
              },
              {
                "$ref": "#/components/schemas/RadioButtonField"
              },
              {
                "$ref": "#/components/schemas/InvisibleSignatureField"
              }
            ],
            "description": "The field definition."
          },
          "recipientId": {
            "type": "string",
            "description": "The ID of the recipient assigned to this task.",
            "format": "uuid",
            "nullable": true
          },
          "stageId": {
            "type": "string",
            "description": "The ID of the Bulk Stage assigned to this task, when the task is not assigned to a specific recipient.",
            "format": "uuid",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the task in the sequence.",
            "format": "int32"
          },
          "source": {
            "$ref": "#/components/schemas/ElementSource"
          }
        },
        "additionalProperties": false,
        "description": "A task assigned to a field on a bulk-envelope file."
      },
      "BulkEnvelopeFieldTaskListResponse": {
        "required": [
          "tasks"
        ],
        "type": "object",
        "properties": {
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeFieldTask"
            },
            "description": "The list of tasks."
          }
        },
        "additionalProperties": false,
        "description": "List of field tasks of a bulk-envelope file."
      },
      "BulkEnvelopeFieldTaskRequest": {
        "required": [
          "field",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "field": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/SignatureField"
              },
              {
                "$ref": "#/components/schemas/TextInputField"
              },
              {
                "$ref": "#/components/schemas/CheckboxField"
              },
              {
                "$ref": "#/components/schemas/DropDownField"
              },
              {
                "$ref": "#/components/schemas/ListBoxField"
              },
              {
                "$ref": "#/components/schemas/AttachmentField"
              },
              {
                "$ref": "#/components/schemas/LinkField"
              },
              {
                "$ref": "#/components/schemas/FileReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/PageReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/AreaReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/ApprovalField"
              },
              {
                "$ref": "#/components/schemas/AnnotationField"
              },
              {
                "$ref": "#/components/schemas/RadioButtonField"
              },
              {
                "$ref": "#/components/schemas/InvisibleSignatureField"
              }
            ],
            "description": "The field definition."
          },
          "recipientId": {
            "type": "string",
            "description": "The ID of the recipient assigned to this task.",
            "format": "uuid",
            "nullable": true
          },
          "stageId": {
            "type": "string",
            "description": "The ID of the Bulk Stage assigned to this task, when the task is not assigned to a specific recipient.",
            "format": "uuid",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the task in the sequence.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "A task assigned to a field on a bulk-envelope file, as submitted by the client."
      },
      "BulkEnvelopeFileDetailResponse": {
        "type": "object",
        "properties": {
          "documentClass": {
            "$ref": "#/components/schemas/BulkEnvelopeFileDocumentClassResponse"
          },
          "restrictedVisibilityRecipientIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The IDs of recipients with restricted visibility to this file, or null if not set.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Response containing details of a bulk envelope file."
      },
      "BulkEnvelopeFileDocumentClassResponse": {
        "required": [
          "id",
          "metadata"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The assigned document class ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The document class name, or null if none is assigned.",
            "nullable": true
          },
          "metadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/NumberFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/DateFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/ListOptionFileMetadataValueResponse"
                }
              ],
              "description": "A metadata field value of a file. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
            },
            "description": "The metadata field values for this file."
          }
        },
        "additionalProperties": false,
        "description": "Response containing the document class assigned to a bulk envelope file."
      },
      "BulkEnvelopeFileListResponse": {
        "required": [
          "files"
        ],
        "type": "object",
        "properties": {
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeFileSummaryResponse"
            },
            "description": "The list of files."
          }
        },
        "additionalProperties": false,
        "description": "List of bulk envelope files."
      },
      "BulkEnvelopeFileSummaryResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The file ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000020"
          },
          "name": {
            "type": "string",
            "description": "The file name.",
            "example": "contract.pdf"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The file sort order.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Summary of a bulk envelope file."
      },
      "BulkEnvelopeListResponse": {
        "required": [
          "bulkEnvelopes",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "bulkEnvelopes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeSummary"
            },
            "description": "The list of bulk envelopes."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of bulk envelopes."
      },
      "BulkEnvelopeReminderResponse": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "BulkEnvelopeResponse": {
        "required": [
          "createdAt",
          "fileRestrictedVisibility",
          "files",
          "id",
          "qualifiedTimeStamp",
          "signatureFormat",
          "stages",
          "status",
          "updatedAt"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The bulk envelope ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          },
          "name": {
            "type": "string",
            "description": "The bulk envelope name.",
            "nullable": true,
            "example": "Bulk contract for onboarding"
          },
          "status": {
            "type": "string",
            "description": "The current status of the bulk envelope.",
            "example": "Draft"
          },
          "createdAt": {
            "type": "string",
            "description": "When the bulk envelope was created.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the bulk envelope was last updated.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteBulkEnvelopeExpirationResponse"
              },
              {
                "$ref": "#/components/schemas/RelativeBulkEnvelopeExpirationResponse"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/BulkEnvelopeReminderResponse"
          },
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeStageSummaryResponse"
            },
            "description": "The stages of the bulk envelope."
          },
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeFileSummaryResponse"
            },
            "description": "The files of the bulk envelope."
          },
          "sentAt": {
            "type": "string",
            "description": "When the bulk envelope was sent.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-01-02T12:00:00Z"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the bulk envelope must use a qualified timestamp server.",
            "example": true
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the bulk envelope, or null.",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "statusChangeReason": {
            "type": "string",
            "description": "The reason for the bulk envelope's terminal status change, otherwise null.",
            "nullable": true,
            "example": "Document no longer required"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language, or null when no custom agreements are configured.",
            "nullable": true
          },
          "fileRestrictedVisibility": {
            "type": "boolean",
            "description": "Whether file visibility is restricted per recipient.",
            "example": false
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the bulk envelope.",
            "nullable": true,
            "example": "https://example.com/bulk-envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a bulk envelope parent."
      },
      "BulkEnvelopeSortingKey": {
        "enum": [
          "LastUpdated",
          "Name"
        ],
        "type": "string",
        "description": "The available sorting keys for listing bulk envelopes."
      },
      "BulkEnvelopeStageAutomaticRecipientSummary": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BulkEnvelopeStageRecipientSummary"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "The friendly name of the eSealing signature profile used for automatic signing.",
                "nullable": true,
                "example": "default-eseal-profile"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Stage summary for an Automatic signer recipient."
      },
      "BulkEnvelopeStageListResponse": {
        "required": [
          "stages"
        ],
        "type": "object",
        "properties": {
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeStageSummary"
            },
            "description": "The list of stages."
          }
        },
        "additionalProperties": false,
        "description": "List of bulk envelope stages."
      },
      "BulkEnvelopeStageRecipientResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The recipient ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000100"
          },
          "languageCode": {
            "type": "string",
            "description": "The language code for the recipient's notifications.",
            "nullable": true,
            "example": "en"
          },
          "givenName": {
            "type": "string",
            "description": "The recipient's first name.",
            "nullable": true,
            "example": "Mario"
          },
          "surname": {
            "type": "string",
            "description": "The recipient's last name.",
            "nullable": true,
            "example": "Rossi"
          },
          "email": {
            "type": "string",
            "description": "The recipient's email address.",
            "nullable": true,
            "example": "mario.rossi@example.com"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The recipient's phone number.",
            "nullable": true,
            "example": "+39123456789"
          },
          "notificationChannels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NotificationChannel"
            },
            "description": "Channels used to notify the recipient.",
            "nullable": true
          },
          "authentication": {
            "$ref": "#/components/schemas/RecipientAuthentication"
          },
          "signatureConfiguration": {
            "$ref": "#/components/schemas/RecipientSignatureData"
          },
          "personalMessage": {
            "type": "string",
            "description": "A personal message included in the notification.",
            "nullable": true,
            "example": "Please review and sign the attached contract."
          },
          "metadata": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RecipientMetadataEntry"
            },
            "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
            "nullable": true
          },
          "signatureReason": {
            "type": "string",
            "description": "Reason displayed at the recipient signing step.",
            "nullable": true,
            "example": "I agree to the terms."
          },
          "isSignatureReasonEditable": {
            "type": "boolean",
            "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
            "nullable": true,
            "example": false
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a Standard recipient on a bulk envelope stage."
      },
      "BulkEnvelopeStageRecipientSummary": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The recipient ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000100"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a bulk envelope stage recipient. Base for polymorphic response."
      },
      "BulkEnvelopeStageResponse": {
        "required": [
          "id",
          "mode",
          "name",
          "recipients",
          "requiredRecipientCompletions",
          "sortOrder",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Stage 1"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32",
            "example": 1
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "mode": {
            "$ref": "#/components/schemas/StageMode"
          },
          "recipients": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/BulkEnvelopeStageStandardRecipientSummary"
                },
                {
                  "$ref": "#/components/schemas/BulkEnvelopeStageAutomaticRecipientSummary"
                }
              ],
              "description": "Summary representation of a bulk envelope stage recipient. Base for polymorphic response."
            },
            "description": "The recipients of the stage."
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a bulk envelope stage."
      },
      "BulkEnvelopeStageSortOrder": {
        "required": [
          "id",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The new position of the stage.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Sort order entry for a bulk envelope stage."
      },
      "BulkEnvelopeStageStandardRecipientSummary": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BulkEnvelopeStageRecipientSummary"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true,
                "example": "Mario"
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true,
                "example": "Rossi"
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true,
                "example": "mario.rossi@example.com"
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true,
                "example": "+39123456789"
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Stage summary for a standard recipient."
      },
      "BulkEnvelopeStageSummary": {
        "required": [
          "id",
          "mode",
          "name",
          "requiredRecipientCompletions",
          "sortOrder",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Stage 1"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32",
            "example": 1
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "mode": {
            "$ref": "#/components/schemas/StageMode"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a bulk envelope stage."
      },
      "BulkEnvelopeStageSummaryResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Stage 1"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Stage summary within a bulk envelope response."
      },
      "BulkEnvelopeSummary": {
        "required": [
          "createdAt",
          "id",
          "name",
          "status",
          "updatedAt"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The bulk envelope ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          },
          "name": {
            "type": "string",
            "description": "The bulk envelope name.",
            "example": "Bulk contract for onboarding"
          },
          "status": {
            "type": "string",
            "description": "The current status of the bulk envelope.",
            "example": "Draft"
          },
          "createdAt": {
            "type": "string",
            "description": "When the bulk envelope was created.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the bulk envelope was last updated.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "sentAt": {
            "type": "string",
            "description": "When the bulk envelope was sent.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-01-02T12:00:00Z"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a bulk envelope parent."
      },
      "BusinessRoleDetails": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The business role ID.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          },
          "name": {
            "type": "string",
            "description": "The business role name.",
            "example": "Approver"
          },
          "description": {
            "type": "string",
            "description": "The business role description.",
            "nullable": true,
            "example": "Approves envelopes before completion."
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a business role."
      },
      "BusinessRoleListResponse": {
        "required": [
          "items",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BusinessRoleSummary"
            },
            "description": "The list of business roles."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "List of business roles."
      },
      "BusinessRoleSummary": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The business role ID.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          },
          "name": {
            "type": "string",
            "description": "The business role name.",
            "example": "Approver"
          },
          "description": {
            "type": "string",
            "description": "The business role description.",
            "nullable": true,
            "example": "Approves envelopes before completion."
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a business role."
      },
      "BusinessRolesSortingKey": {
        "enum": [
          "Name"
        ],
        "type": "string",
        "description": "The available sorting keys for listing business roles."
      },
      "CancelEnvelopeRequest": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "description": "Free-text reason for the cancellation. Optional.",
            "nullable": true,
            "example": "No longer needed"
          }
        },
        "additionalProperties": false,
        "description": "Optional request body for canceling an envelope."
      },
      "CheckboxField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "checked": {
                "type": "boolean",
                "description": "Whether the checkbox is checked."
              },
              "value": {
                "type": "string",
                "description": "The value of the checkbox.",
                "nullable": true
              },
              "readOnly": {
                "type": "boolean",
                "description": "Whether the field is read-only."
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "Checkbox"
            ],
            "type": "string",
            "default": "Checkbox"
          }
        },
        "description": "A checkbox field.",
        "example": {
          "fieldType": "Checkbox",
          "checked": true,
          "value": "yes",
          "readOnly": false,
          "required": false,
          "positionX": 50,
          "positionY": 300,
          "width": 20,
          "height": 20,
          "page": 1,
          "id": "chk1"
        }
      },
      "ClickToSignSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "ClickToSignSignature"
            ],
            "type": "string",
            "default": "ClickToSignSignature"
          }
        },
        "additionalProperties": false,
        "description": "Click to sign signature configuration.",
        "example": {
          "signatureType": "ClickToSignSignature"
        }
      },
      "CloneEnvelopeResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the cloned envelope.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000050"
          }
        },
        "additionalProperties": false,
        "description": "Response after cloning an envelope."
      },
      "CountryListResponse": {
        "required": [
          "countries"
        ],
        "type": "object",
        "properties": {
          "countries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CountryResponse"
            },
            "description": "The list of countries."
          }
        },
        "additionalProperties": false,
        "description": "List of available countries."
      },
      "CountryResponse": {
        "required": [
          "code",
          "name"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The ISO 3166-1 alpha-2 country code.",
            "example": "US"
          },
          "name": {
            "type": "string",
            "description": "The display name of the country.",
            "example": "United States"
          }
        },
        "additionalProperties": false,
        "description": "A country available for selection."
      },
      "CreateAccessCode": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The access code.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Access code configuration for creation."
      },
      "CreateApplicationRoleRequest": {
        "required": [
          "name",
          "permissions"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The application role name.",
            "example": "Contract Reviewer"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "description": "The entity/action permission pairs granted by the application role."
          },
          "description": {
            "type": "string",
            "description": "The application role description.",
            "nullable": true,
            "example": "Can read envelopes"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating an application role."
      },
      "CreateApplicationRoleResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created application role.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating an application role."
      },
      "CreateAuthenticationOneTimePassword": {
        "required": [
          "channel"
        ],
        "type": "object",
        "properties": {
          "channel": {
            "$ref": "#/components/schemas/OneTimePasswordAuthenticationChannel"
          }
        },
        "additionalProperties": false,
        "description": "OTP authentication configuration for creation."
      },
      "CreateBulkEnvelopeReminder": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "CreateBulkEnvelopeRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The bulk envelope name.",
            "nullable": true,
            "example": "Bulk contract for Q1 campaign"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteCreateBulkEnvelopeExpiration"
              },
              {
                "$ref": "#/components/schemas/RelativeCreateBulkEnvelopeExpiration"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/CreateBulkEnvelopeReminder"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the bulk envelope must use a qualified timestamp server.",
            "nullable": true,
            "example": true
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the bulk envelope.",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language. Null means no change (keep existing); empty list clears all agreements.",
            "nullable": true
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the bulk envelope.",
            "nullable": true,
            "example": "https://example.com/bulk-envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a bulk envelope."
      },
      "CreateBulkEnvelopeResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created bulk envelope.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a bulk envelope."
      },
      "CreateBulkEnvelopeStageAutomaticRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateBulkEnvelopeStageRecipientRequest"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "Signature profile name for the automatic recipient.",
                "nullable": true,
                "example": "default-eseal-profile"
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Request to create an automatic recipient on a bulk envelope stage.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "signatureReason": "I agree to the terms.",
          "languageCode": "en"
        }
      },
      "CreateBulkEnvelopeStageRecipientRequest": {
        "type": "object",
        "properties": {
          "languageCode": {
            "type": "string",
            "description": "BCP 47 language code for recipient notifications.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "Base record for create bulk envelope stage recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
      },
      "CreateBulkEnvelopeStageRecipientResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created recipient.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000100"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a recipient on a bulk envelope stage."
      },
      "CreateBulkEnvelopeStageRequest": {
        "required": [
          "mode",
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "mode": {
            "$ref": "#/components/schemas/StageMode"
          },
          "name": {
            "type": "string",
            "description": "The stage name. If omitted, the stage is created with an empty name.",
            "nullable": true,
            "example": "Stage 1"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage. Ignored (may be omitted) when `Mode` is `Bulk`, or when `Type` is `Automatic` or `CarbonCopy`. Required (greater than 0) otherwise.",
            "format": "int32",
            "nullable": true,
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a bulk envelope stage."
      },
      "CreateBulkEnvelopeStageResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created stage.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a bulk envelope stage."
      },
      "CreateBulkEnvelopeStageStandardRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateBulkEnvelopeStageRecipientRequest"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true,
                "example": "Mario"
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true,
                "example": "Rossi"
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true,
                "example": "mario.rossi@example.com"
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true,
                "example": "+39123456789"
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/CreateRecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/CreateRecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true,
                "example": "Please review and sign the attached contract."
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Request body for creating a Standard recipient on a bulk envelope stage."
      },
      "CreateBusinessRoleRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The business role name.",
            "example": "Approver"
          },
          "description": {
            "type": "string",
            "description": "The optional business role description.",
            "nullable": true,
            "example": "Approves envelopes before completion."
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a business role."
      },
      "CreateBusinessRoleResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created business role.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a business role."
      },
      "CreateDateDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "Request body for creating a document metadata field of type `MetadataValueType.DateType`.",
        "example": {
          "type": "DateType",
          "name": "SignatureDate"
        }
      },
      "CreateDateDocumentMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataResponse"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "Response after creating a document metadata field of type `MetadataValueType.DateType`.",
        "example": {
          "type": "DateType",
          "id": "3b5ef511-7aee-40c7-9041-c0efd2b797d8"
        }
      },
      "CreateDisposableCertificate": {
        "type": "object",
        "properties": {
          "document": {
            "$ref": "#/components/schemas/CreateDisposableCertificateDocument"
          },
          "identification": {
            "$ref": "#/components/schemas/CreateDisposableCertificateIdentification"
          },
          "verificationPhoneNumber": {
            "type": "string",
            "description": "The phone number for verification.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Disposable certificate configuration for creation."
      },
      "CreateDisposableCertificateDocument": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The document type.",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "The document number.",
            "nullable": true
          },
          "serialNumber": {
            "type": "string",
            "description": "The document serial number.",
            "nullable": true
          },
          "issuingCountry": {
            "type": "string",
            "description": "The issuing country.",
            "nullable": true
          },
          "issuedBy": {
            "type": "string",
            "description": "The issuing authority.",
            "nullable": true
          },
          "issuedOn": {
            "type": "string",
            "description": "When the document was issued.",
            "format": "date-time",
            "nullable": true
          },
          "expiresAt": {
            "type": "string",
            "description": "When the document expires.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Identity document for disposable certificate during creation."
      },
      "CreateDisposableCertificateIdentification": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/DisposableCertificateIdentificationType"
          },
          "issuingCountry": {
            "type": "string",
            "description": "The issuing country.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Identification method for disposable certificate during creation."
      },
      "CreateDocumentClassRequest": {
        "required": [
          "description",
          "metadata",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The document class name.",
            "example": "Contract"
          },
          "description": {
            "type": "string",
            "description": "The document class description.",
            "example": "Documents related to contracts"
          },
          "metadata": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DocumentClassMetadataReferenceRequest"
            },
            "description": "The metadata field references for this document class."
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a document class."
      },
      "CreateDocumentClassResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created document class.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a document class."
      },
      "CreateDocumentMetadataRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a document metadata field. Discriminated by the `type` property."
      },
      "CreateDocumentMetadataResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a document metadata field. Discriminated by the `type` property."
      },
      "CreateEnvelopeAutomaticRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateEnvelopeRecipientRequest"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "Signature profile name for the automatic recipient.",
                "nullable": true,
                "example": "default-eseal-profile"
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Request to create an automatic recipient in an envelope stage.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "signatureReason": "I agree to the terms.",
          "languageCode": "en"
        }
      },
      "CreateEnvelopeFromTemplateResponse": {
        "required": [
          "createdEnvelopeId"
        ],
        "type": "object",
        "properties": {
          "createdEnvelopeId": {
            "type": "string",
            "description": "The ID of the created envelope.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating an envelope from a template."
      },
      "CreateEnvelopeRecipientRequest": {
        "type": "object",
        "properties": {
          "languageCode": {
            "type": "string",
            "description": "BCP 47 language code for recipient notifications.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "Base record for create envelope recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
      },
      "CreateEnvelopeRecipientResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created recipient.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000100"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a recipient."
      },
      "CreateEnvelopeReminder": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "CreateEnvelopeRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The envelope name.",
            "nullable": true,
            "example": "Contract for Mario Rossi"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteCreateEnvelopeExpiration"
              },
              {
                "$ref": "#/components/schemas/RelativeCreateEnvelopeExpiration"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/CreateEnvelopeReminder"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the envelope must use a qualified timestamp server.",
            "nullable": true,
            "example": true
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the envelope.",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language. Null means no change (keep existing); empty list clears all agreements.",
            "nullable": true
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the envelope.",
            "nullable": true,
            "example": "https://example.com/envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating an envelope."
      },
      "CreateEnvelopeResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created envelope.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating an envelope."
      },
      "CreateEnvelopeStageRequest": {
        "required": [
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "name": {
            "type": "string",
            "description": "The stage name. If omitted, the stage is created with an empty name.",
            "nullable": true,
            "example": "Stage 1"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage. Ignored (may be omitted) when `Type` is `Automatic` or `CarbonCopy`. Required (greater than 0) for every other stage type.",
            "format": "int32",
            "nullable": true,
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a stage."
      },
      "CreateEnvelopeStageResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created stage.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a stage."
      },
      "CreateEnvelopeStandardRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateEnvelopeRecipientRequest"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true,
                "example": "Mario"
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true,
                "example": "Rossi"
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true,
                "example": "mario.rossi@example.com"
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true,
                "example": "+39123456789"
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/CreateRecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/CreateRecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true,
                "example": "Please review and sign the attached contract."
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Request body for creating a Standard recipient."
      },
      "CreateEnvelopeWebhookRequest": {
        "required": [
          "event",
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls (max 2048 characters).",
            "example": "https://example.com/hooks/envelope"
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationRequest"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating an envelope webhook."
      },
      "CreateEnvelopeWebhookResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created webhook.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating an envelope webhook."
      },
      "CreateListOptionDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "properties": {
              "options": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DocumentMetadataOptionRequest"
                },
                "description": "The predefined selectable options. Must be non-empty.",
                "nullable": true
              },
              "parentId": {
                "type": "string",
                "description": "The ID of an existing metadata field of type ListOptionType to set as this field's parent, or omit for no parent. Must not be this field itself or one of its children.",
                "format": "uuid",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "Request body for creating a document metadata field of type `MetadataValueType.ListOptionType`.",
        "example": {
          "options": [
            {
              "value": "Invoice",
              "parentId": "a36472ee-254d-4668-a9c8-18149720e4b9"
            },
            {
              "value": "NDA",
              "parentId": "ec13bf6f-eab9-4eb9-84a0-dbfc30935ff7"
            }
          ],
          "parentId": "8c1e9998-4746-4d94-8eaf-fb1463c43ae6",
          "type": "ListOptionType",
          "name": "ContractType"
        }
      },
      "CreateListOptionDocumentMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataResponse"
          },
          {
            "type": "object",
            "properties": {
              "options": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DocumentMetadataOptionItem"
                },
                "description": "The predefined selectable options.",
                "nullable": true
              },
              "parentId": {
                "type": "string",
                "description": "The ID of the parent metadata field this field depends on, when defined.",
                "format": "uuid",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "Response after creating a document metadata field of type `MetadataValueType.ListOptionType`.",
        "example": {
          "options": [
            {
              "id": "db9b8856-5cf2-406e-a0b4-e5f56d25a4e3",
              "value": "Invoice",
              "parentId": "67c7ed8c-c16b-4887-8f2a-eb1c2c45dbef"
            },
            {
              "id": "d0e07435-7edd-481a-933b-c983e522991d",
              "value": "NDA"
            }
          ],
          "parentId": "61d4c172-b9b1-461e-8f44-53912b9a8d20",
          "type": "ListOptionType",
          "id": "c97a4e58-f410-4d08-8c80-e35cbe172594"
        }
      },
      "CreateNumberDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "Request body for creating a document metadata field of type `MetadataValueType.NumberType`.",
        "example": {
          "type": "NumberType",
          "name": "TotalAmount"
        }
      },
      "CreateNumberDocumentMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataResponse"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "Response after creating a document metadata field of type `MetadataValueType.NumberType`.",
        "example": {
          "type": "NumberType",
          "id": "b4483424-9dad-444f-9eaa-8931f53e39fd"
        }
      },
      "CreateOAuthAuthentication": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "providerName": {
            "type": "string",
            "description": "The OAuth provider name.",
            "nullable": true
          },
          "id": {
            "type": "string",
            "description": "The identifier of the OAuth provider.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "OAuth authentication configuration for creation."
      },
      "CreateOrganizationWebhookRequest": {
        "required": [
          "event",
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls (max 2048 characters).",
            "example": "https://example.com/hooks/organization"
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationRequest"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating an organization webhook."
      },
      "CreateOrganizationWebhookResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created webhook.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating an organization webhook."
      },
      "CreateOtpSignature": {
        "type": "object",
        "properties": {
          "channel": {
            "$ref": "#/components/schemas/OtpDeliveryChannel"
          }
        },
        "additionalProperties": false,
        "description": "OTP signature configuration for creation."
      },
      "CreatePolicyRequest": {
        "required": [
          "actions",
          "conditions",
          "isActive",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The policy name.",
            "example": "Standard signing policy"
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether the policy is active.",
            "example": true
          },
          "description": {
            "type": "string",
            "description": "The policy description.",
            "nullable": true,
            "example": "Policy applied to all standard signing envelopes"
          },
          "documentClassId": {
            "type": "string",
            "description": "The document class this policy applies to, when set.",
            "format": "uuid",
            "nullable": true
          },
          "conditions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyConditionRequest"
            },
            "description": "The policy's conditions. `sortOrder` must start at 1, be unique, and contiguous within the list."
          },
          "actions": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/AddEnvelopeStageConfigurationActionRequest"
                }
              ],
              "description": "A single action within a policy request. Discriminated by the `type` property."
            },
            "description": "The policy's actions. `sortOrder` must start at 1, be unique, and contiguous within the list."
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a policy."
      },
      "CreateRecipientAuthentication": {
        "type": "object",
        "properties": {
          "accessCode": {
            "$ref": "#/components/schemas/CreateAccessCode"
          },
          "oneTimePassword": {
            "$ref": "#/components/schemas/CreateAuthenticationOneTimePassword"
          },
          "oAuthAuthentications": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreateOAuthAuthentication"
            },
            "description": "OAuth authentications.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Recipient authentication configuration for creation."
      },
      "CreateRecipientSignatureData": {
        "type": "object",
        "properties": {
          "disposableCertificate": {
            "$ref": "#/components/schemas/CreateDisposableCertificate"
          },
          "remoteCertificate": {
            "$ref": "#/components/schemas/CreateRemoteCertificateDto"
          },
          "otpSignature": {
            "$ref": "#/components/schemas/CreateOtpSignature"
          },
          "signingPlugins": {
            "$ref": "#/components/schemas/CreateSigningPlugins"
          }
        },
        "additionalProperties": false,
        "description": "Signature configuration for a recipient during creation."
      },
      "CreateRemoteCertificateDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "description": "The user ID.",
            "nullable": true
          },
          "deviceId": {
            "type": "string",
            "description": "The device ID.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Remote certificate configuration for creation."
      },
      "CreateSignatureLayoutResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The identifier of the created signature layout.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response returned after creating a signature layout."
      },
      "CreateSigningPlugin": {
        "type": "object",
        "properties": {
          "pluginId": {
            "type": "string",
            "description": "The plugin ID.",
            "nullable": true
          },
          "settings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreateSigningPluginSetting"
            },
            "description": "The plugin settings.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A signing plugin for creation."
      },
      "CreateSigningPluginSetting": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The setting key.",
            "nullable": true
          },
          "value": {
            "type": "string",
            "description": "The setting value.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A signing plugin setting for creation."
      },
      "CreateSigningPlugins": {
        "type": "object",
        "properties": {
          "plugins": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreateSigningPlugin"
            },
            "description": "The list of signing plugins.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Signing plugins configuration for creation."
      },
      "CreateStringDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "Request body for creating a document metadata field of type `MetadataValueType.StringType`.",
        "example": {
          "type": "StringType",
          "name": "ContractNumber"
        }
      },
      "CreateStringDocumentMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateDocumentMetadataResponse"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "Response after creating a document metadata field of type `MetadataValueType.StringType`.",
        "example": {
          "type": "StringType",
          "id": "745322f7-2ef0-46ed-b928-b999f00d679e"
        }
      },
      "CreateTemplateAutomaticRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateTemplateRecipientRequest"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "The friendly name of the eSealing signature profile.",
                "nullable": true
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Request body for creating an Automatic recipient.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "signatureReason": "I agree to the terms.",
          "languageCode": "en"
        }
      },
      "CreateTemplateRecipientRequest": {
        "type": "object",
        "properties": {
          "languageCode": {
            "type": "string",
            "description": "BCP 47 language code for recipient notifications.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "Base record for create template recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
      },
      "CreateTemplateRecipientResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created recipient.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a recipient."
      },
      "CreateTemplateReminder": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "CreateTemplateRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The template name.",
            "nullable": true,
            "example": "Standard NDA template"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteCreateTemplateExpiration"
              },
              {
                "$ref": "#/components/schemas/RelativeCreateTemplateExpiration"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/CreateTemplateReminder"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the template must use a qualified timestamp server.",
            "nullable": true,
            "example": true
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the template.",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language. Null means no change (keep existing); empty list clears all agreements.",
            "nullable": true
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the envelope.",
            "nullable": true,
            "example": "https://example.com/envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a template."
      },
      "CreateTemplateResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created template.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a template."
      },
      "CreateTemplateStageRequest": {
        "required": [
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "name": {
            "type": "string",
            "description": "The stage name. If omitted, the stage is created with an empty name.",
            "nullable": true,
            "example": "Stage 1"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage. Ignored (may be omitted) when `Type` is `Automatic` or `CarbonCopy`. Required (greater than 0) for every other stage type.",
            "format": "int32",
            "nullable": true,
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a stage."
      },
      "CreateTemplateStageResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created stage.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a stage."
      },
      "CreateTemplateStandardRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/CreateTemplateRecipientRequest"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/CreateRecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/CreateRecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Request body for creating a Standard recipient."
      },
      "CreateUserGroupContactRequest": {
        "type": "object",
        "properties": {
          "givenName": {
            "type": "string",
            "description": "The contact's first name.",
            "nullable": true,
            "example": "John"
          },
          "surname": {
            "type": "string",
            "description": "The contact's last name.",
            "nullable": true,
            "example": "Smith"
          },
          "email": {
            "type": "string",
            "description": "The contact's email address.",
            "nullable": true,
            "example": "john.smith@example.com"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The contact's phone number.",
            "nullable": true,
            "example": "+44 20 7946 0958"
          },
          "language": {
            "type": "string",
            "description": "The contact's culture ISO code.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": {},
        "description": "Request body for creating a contact in a user group. The values of the group's custom fields are sent as\nadditional properties next to the standard fields, keyed by custom field name (e.g. `\"Tax code\": \"AB123456C\"`)."
      },
      "CreateUserGroupContactResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created contact.",
            "format": "uuid",
            "example": "e201ace1-7752-4a33-a9b3-2a46902e8de3"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a contact in a user group."
      },
      "CreateUserGroupRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The user group name.",
            "example": "Sales Team"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a user group."
      },
      "CreateUserGroupResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created user group.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a user group."
      },
      "CreateUserRequest": {
        "required": [
          "email",
          "givenName",
          "regionalSettings",
          "surname"
        ],
        "type": "object",
        "properties": {
          "givenName": {
            "type": "string",
            "description": "The user's first name.",
            "example": "Mario"
          },
          "surname": {
            "type": "string",
            "description": "The user's last name.",
            "example": "Rossi"
          },
          "email": {
            "type": "string",
            "description": "The user's email address.",
            "example": "mario.rossi@example.com"
          },
          "regionalSettings": {
            "$ref": "#/components/schemas/UserRegionalSettingsRequest"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The user's optional phone number.",
            "nullable": true,
            "example": "+39021234567"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a user within an organization."
      },
      "CreateUserResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created user.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a user within an organization."
      },
      "CreateWebhookSubscriptionRequest": {
        "required": [
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The HTTPS URL to receive webhook events."
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationRequest"
          }
        },
        "additionalProperties": false,
        "description": "Request body for creating a webhook subscription."
      },
      "CreatedPolicyResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the created policy.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a policy."
      },
      "DateAnnotationValueFormat": {
        "required": [
          "annotationType",
          "format"
        ],
        "type": "object",
        "properties": {
          "annotationType": {
            "enum": [
              "Date"
            ],
            "type": "string",
            "default": "Date"
          },
          "format": {
            "$ref": "#/components/schemas/DateFormat"
          }
        },
        "additionalProperties": false,
        "description": "Date annotation value format."
      },
      "DateDocumentClassMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentClassMetadataResponse"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "A document class metadata field carrying a date value.",
        "example": {
          "type": "DateType",
          "id": "9f1da3c0-6c64-467a-a4ee-e933e26ab15c",
          "name": "SignatureDate",
          "required": false,
          "sortOrder": 3
        }
      },
      "DateDocumentMetadataItem": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentMetadataItem"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "An organization-level document metadata field of type `MetadataValueType.DateType`.",
        "example": {
          "type": "DateType",
          "id": "610e4bea-5bdf-40b9-873f-88975f4779fd",
          "name": "SignatureDate"
        }
      },
      "DateFileMetadataValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/FileMetadataValueResponse"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The date value, or null if not set.",
                "format": "date",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "An ISO-8601 date metadata value of a file.",
        "example": {
          "value": "2026-05-20",
          "type": "DateType",
          "id": "a0826875-fcde-49d9-9ae1-9b6b8ba72cd9",
          "name": "SignDate"
        }
      },
      "DateFormat": {
        "enum": [
          "dd.MM.yy",
          "dd.MM.yyyy"
        ],
        "type": "string",
        "description": "Available date display formats for a date text input."
      },
      "DateInputConfig": {
        "required": [
          "format",
          "textInputType"
        ],
        "type": "object",
        "properties": {
          "textInputType": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          },
          "value": {
            "type": "string",
            "description": "The date value.",
            "format": "date",
            "nullable": true
          },
          "format": {
            "$ref": "#/components/schemas/DateFormat"
          },
          "minValue": {
            "type": "string",
            "description": "The minimum allowed date.",
            "format": "date",
            "nullable": true
          },
          "maxValue": {
            "type": "string",
            "description": "The maximum allowed date.",
            "format": "date",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Configuration for a date text input.",
        "example": {
          "textInputType": "DateType",
          "value": "2025-12-31",
          "format": "dd.MM.yyyy",
          "minValue": "2025-01-01",
          "maxValue": "2026-12-31"
        }
      },
      "DateMetadataValueRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/MetadataValueRequest"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The date value.",
                "format": "date"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "A metadata value carrying an ISO-8601 date payload."
      },
      "DatePolicyConditionMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataRequest"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The comparison date value.",
                "format": "date"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "A policy condition's comparison value for a date-type metadata field."
      },
      "DatePolicyConditionValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataResponse"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The comparison date value.",
                "format": "date"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "A policy condition's comparison value for a date-type metadata field."
      },
      "DateTimeFormat": {
        "enum": [
          "dd/MM/yyyy | HH:mm",
          "dd/MM/yy | HH:mm",
          "dd-MMM-yy | HH:mm",
          "dd-MMM-yyyy | HH:mm",
          "dd MMMM yyyy | HH:mm",
          "yyyy-MM-dd | HH:mm",
          "yyyy-MMM-dd | HH:mm",
          "yyyy MMMM dd | HH:mm",
          "MMM d, yyyy | HH:mm",
          "MMM-dd-yyyy | HH:mm",
          "MMMM d, yyyy | HH:mm",
          "MM/d/yyyy | HH:mm",
          "dd.MM.yyyy | HH:mm",
          "dd. MMMM yyyy | HH:mm",
          "dd.MM.yy | HH:mm"
        ],
        "type": "string",
        "description": "Available date and time format patterns for regional settings."
      },
      "DateTimeFormatListResponse": {
        "required": [
          "dateTimeFormats"
        ],
        "type": "object",
        "properties": {
          "dateTimeFormats": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DateTimeFormatResponse"
            },
            "description": "The list of date/time formats."
          }
        },
        "additionalProperties": false,
        "description": "List of available date/time formats."
      },
      "DateTimeFormatResponse": {
        "required": [
          "code"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The date and time format pattern.",
            "example": "dd/MM/yyyy | HH:mm"
          }
        },
        "additionalProperties": false,
        "description": "A date/time format available for selection."
      },
      "DecimalSeparator": {
        "enum": [
          "Comma",
          "Point",
          "Apostrophe",
          "None"
        ],
        "type": "string",
        "description": "The decimal separator used by a number text input."
      },
      "DefaultSignatureType": {
        "enum": [
          "ClickToSign",
          "DrawToSign",
          "TypeToSign",
          "RemoteCertificate",
          "Biometric",
          "LocalCertificate",
          "DisposableCertificate",
          "OneTimePassword"
        ],
        "type": "string",
        "description": "The default signature types supported by the settings/signature endpoint."
      },
      "DefaultSignatureTypeOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/DefaultSignatureType"
          }
        },
        "additionalProperties": false
      },
      "DisposableCertificate": {
        "type": "object",
        "properties": {
          "document": {
            "$ref": "#/components/schemas/DisposableCertificateDocument"
          },
          "identification": {
            "$ref": "#/components/schemas/DisposableCertificateIdentification"
          },
          "verificationPhoneNumber": {
            "type": "string",
            "description": "The phone number for verification.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Disposable certificate configuration."
      },
      "DisposableCertificateDocument": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The document type.",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "The document number.",
            "nullable": true
          },
          "serialNumber": {
            "type": "string",
            "description": "The document serial number.",
            "nullable": true
          },
          "issuingCountry": {
            "type": "string",
            "description": "The issuing country.",
            "nullable": true
          },
          "issuedBy": {
            "type": "string",
            "description": "The issuing authority.",
            "nullable": true
          },
          "issuedOn": {
            "type": "string",
            "description": "When the document was issued.",
            "format": "date-time",
            "nullable": true
          },
          "expiresAt": {
            "type": "string",
            "description": "When the document expires.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Identity document for disposable certificate."
      },
      "DisposableCertificateIdentification": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/DisposableCertificateIdentificationType"
          },
          "issuingCountry": {
            "type": "string",
            "description": "The issuing country.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Identification method for disposable certificate."
      },
      "DisposableCertificateIdentificationType": {
        "enum": [
          "None",
          "ForeignTaxCode",
          "PersonalNumber",
          "Passport",
          "NationalIdentityCard",
          "ItalianTaxCode",
          "NoSerialNumber",
          "DrivingLicense",
          "ResidencePermit",
          "ResidencePermitTemp",
          "EmbassyDocument",
          "Am"
        ],
        "type": "string",
        "description": "Identification document type for a disposable certificate signature."
      },
      "DisposableCertificateSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "DisposableCertificateSignature"
            ],
            "type": "string",
            "default": "DisposableCertificateSignature"
          }
        },
        "additionalProperties": false,
        "description": "Disposable certificate signature configuration.",
        "example": {
          "signatureType": "DisposableCertificateSignature"
        }
      },
      "DisposableCertificateType": {
        "enum": [
          "Disposable",
          "Disposable30Days"
        ],
        "type": "string",
        "description": "The disposable certificate types supported by an organization."
      },
      "DisposableCertificateTypeOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/DisposableCertificateType"
          }
        },
        "additionalProperties": false
      },
      "DocumentClassListResponse": {
        "required": [
          "documentClasses",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "documentClasses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DocumentClassSummary"
            },
            "description": "The list of document classes."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of document classes."
      },
      "DocumentClassMetadataReferenceRequest": {
        "required": [
          "id",
          "required",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The referenced metadata field ID.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The display order of the metadata field within the document class.",
            "format": "int32",
            "example": 1
          },
          "required": {
            "type": "boolean",
            "description": "Whether the field is required for this document class.",
            "example": true
          }
        },
        "additionalProperties": false,
        "description": "A reference to an existing organization metadata field, attached to a document class."
      },
      "DocumentClassMetadataResponse": {
        "required": [
          "id",
          "name",
          "required",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "A document class metadata field, as returned by the document class GET response. Discriminated by the `type` property."
      },
      "DocumentClassResponse": {
        "required": [
          "description",
          "id",
          "metadata",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The document class ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The document class name."
          },
          "description": {
            "type": "string",
            "description": "The document class description."
          },
          "metadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringDocumentClassMetadataResponse"
                },
                {
                  "$ref": "#/components/schemas/NumberDocumentClassMetadataResponse"
                },
                {
                  "$ref": "#/components/schemas/DateDocumentClassMetadataResponse"
                },
                {
                  "$ref": "#/components/schemas/ListOptionDocumentClassMetadataResponse"
                }
              ],
              "description": "A document class metadata field, as returned by the document class GET response. Discriminated by the `type` property."
            },
            "description": "The list of full metadata field data."
          }
        },
        "additionalProperties": false,
        "description": "Response model for a single document class."
      },
      "DocumentClassSummary": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The document class ID.",
            "format": "uuid",
            "example": "6f2ed3d2-0617-4be4-9445-7e6a4090b260"
          },
          "name": {
            "type": "string",
            "description": "The document class name.",
            "example": "Contract"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a document class."
      },
      "DocumentMetadataItem": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          }
        },
        "additionalProperties": false,
        "description": "Represents a document metadata field at the organization level. Discriminated by the `type` property."
      },
      "DocumentMetadataListResult": {
        "required": [
          "documentMetadata",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "documentMetadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringDocumentMetadataItem"
                },
                {
                  "$ref": "#/components/schemas/NumberDocumentMetadataItem"
                },
                {
                  "$ref": "#/components/schemas/DateDocumentMetadataItem"
                },
                {
                  "$ref": "#/components/schemas/ListOptionDocumentMetadataItem"
                }
              ],
              "description": "Represents a document metadata field at the organization level. Discriminated by the `type` property."
            },
            "description": "The metadata fields on the current page."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of document metadata fields."
      },
      "DocumentMetadataOptionItem": {
        "required": [
          "id",
          "value"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The option ID.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          },
          "value": {
            "type": "string",
            "description": "The option value.",
            "example": "Invoice"
          },
          "parentId": {
            "type": "string",
            "description": "The ID of the parent metadata field's option value this option is tied to, when the field has a parent.",
            "format": "uuid",
            "nullable": true,
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "A predefined selectable option value for a list-option document metadata field, as returned by the API."
      },
      "DocumentMetadataOptionRequest": {
        "required": [
          "value"
        ],
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "The option value.",
            "example": "Invoice"
          },
          "parentId": {
            "type": "string",
            "description": "The ID of the parent metadata field's option value this option is tied to, when the field has a parent.",
            "format": "uuid",
            "nullable": true,
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "A predefined selectable option value for a list-option document metadata field."
      },
      "DrawToSignSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "DrawToSignSignature"
            ],
            "type": "string",
            "default": "DrawToSignSignature"
          }
        },
        "additionalProperties": false,
        "description": "Draw to sign signature configuration.",
        "example": {
          "signatureType": "DrawToSignSignature"
        }
      },
      "DropDownField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "font": {
                "$ref": "#/components/schemas/FontStyle"
              },
              "options": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Option"
                },
                "description": "The list of options.",
                "nullable": true
              },
              "readOnly": {
                "type": "boolean",
                "description": "Whether the field is read-only."
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "DropDown"
            ],
            "type": "string",
            "default": "DropDown"
          }
        },
        "description": "A drop-down field.",
        "example": {
          "fieldType": "DropDown",
          "font": {
            "size": 12,
            "name": "Helvetica",
            "color": "#000000",
            "align": "Left",
            "italic": false,
            "bold": false
          },
          "options": [
            {
              "key": "val1",
              "value": "Label 1",
              "selected": false
            },
            {
              "key": "val2",
              "value": "Label 2",
              "selected": true
            }
          ],
          "readOnly": false,
          "required": false,
          "positionX": 50,
          "positionY": 400,
          "width": 150,
          "height": 30,
          "page": 1,
          "id": "dd1"
        }
      },
      "DynamicPolicyRecipientSourceRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyRecipientSourceRequest"
          },
          {
            "type": "object",
            "properties": {
              "userGroupId": {
                "type": "string",
                "description": "The user group ID recipients are resolved from, when set.",
                "format": "uuid",
                "nullable": true
              },
              "businessRoleId": {
                "type": "string",
                "description": "The business role ID recipients are resolved from, when set.",
                "format": "uuid",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Dynamic"
            ],
            "type": "string",
            "default": "Dynamic"
          }
        },
        "description": "Recipients are resolved dynamically from a user group or business role. At least one of `userGroupId`/`businessRoleId` must be set."
      },
      "DynamicPolicyRecipientSourceResponse": {
        "required": [
          "type"
        ],
        "type": "object",
        "properties": {
          "userGroupId": {
            "type": "string",
            "description": "The user group ID recipients are resolved from, when set.",
            "format": "uuid",
            "nullable": true
          },
          "businessRoleId": {
            "type": "string",
            "description": "The business role ID recipients are resolved from, when set.",
            "format": "uuid",
            "nullable": true
          },
          "type": {
            "enum": [
              "Dynamic"
            ],
            "type": "string",
            "default": "Dynamic"
          }
        },
        "additionalProperties": false,
        "description": "A policy action's recipient source resolved dynamically from a user group or business role."
      },
      "ElementSource": {
        "enum": [
          "File",
          "UserDefined"
        ],
        "type": "string",
        "description": "The origin of a field on a file."
      },
      "EligibleParentResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The eligible parent metadata field ID.",
            "format": "uuid",
            "example": "048f2e2c-0f48-498b-953d-02d414c60baf"
          }
        },
        "additionalProperties": false,
        "description": "A document metadata field eligible to be set as the parent of another field."
      },
      "EligibleParentsResponse": {
        "required": [
          "eligibleParents"
        ],
        "type": "object",
        "properties": {
          "eligibleParents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EligibleParentResponse"
            },
            "description": "The list of eligible parent metadata fields."
          }
        },
        "additionalProperties": false,
        "description": "The document metadata fields eligible to be set as the parent of a given field."
      },
      "EmailAnnotationValueFormat": {
        "required": [
          "annotationType"
        ],
        "type": "object",
        "properties": {
          "annotationType": {
            "enum": [
              "Email"
            ],
            "type": "string",
            "default": "Email"
          }
        },
        "additionalProperties": false,
        "description": "Email annotation value format."
      },
      "EnvelopeArtifactListResponse": {
        "required": [
          "artifacts"
        ],
        "type": "object",
        "properties": {
          "artifacts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeArtifactResponse"
            },
            "description": "The list of artifacts."
          }
        },
        "additionalProperties": false,
        "description": "List of envelope artifacts."
      },
      "EnvelopeArtifactResponse": {
        "required": [
          "id",
          "name",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The artifact ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000030"
          },
          "name": {
            "type": "string",
            "description": "The artifact name.",
            "example": "contract-signed.pdf"
          },
          "type": {
            "$ref": "#/components/schemas/EnvelopeArtifactType"
          }
        },
        "additionalProperties": false,
        "description": "Representation of an envelope artifact."
      },
      "EnvelopeArtifactType": {
        "enum": [
          "CompletedFile",
          "AuditTrail",
          "CompletedFiles"
        ],
        "type": "string",
        "description": "The types of artifacts generated during signing."
      },
      "EnvelopeAutomaticRecipientResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeRecipientResponse"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "The friendly name of the eSealing signature profile used for automatic signing.",
                "nullable": true,
                "example": "default-eseal-profile"
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Detailed representation of an Automatic signer recipient.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "id": "00000000-0000-0000-0000-000000000100",
          "languageCode": "en-US"
        }
      },
      "EnvelopeEventActorResponse": {
        "required": [
          "email"
        ],
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email of the actor.",
            "example": "owner@example.com"
          }
        },
        "additionalProperties": false,
        "description": "The actor of an event."
      },
      "EnvelopeEventListResponse": {
        "required": [
          "events"
        ],
        "type": "object",
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeEventResponse"
            },
            "description": "The list of events."
          }
        },
        "additionalProperties": false,
        "description": "List of envelope events."
      },
      "EnvelopeEventResponse": {
        "required": [
          "id",
          "occurredAt",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The event ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000040"
          },
          "type": {
            "type": "string",
            "description": "The event type.",
            "example": "EnvelopeSent"
          },
          "actor": {
            "$ref": "#/components/schemas/EnvelopeEventActorResponse"
          },
          "occurredAt": {
            "type": "string",
            "description": "When the event occurred.",
            "format": "date-time",
            "example": "2025-01-02T12:00:00Z"
          }
        },
        "additionalProperties": false,
        "description": "Representation of an envelope event."
      },
      "EnvelopeFileDetailResponse": {
        "type": "object",
        "properties": {
          "documentClass": {
            "$ref": "#/components/schemas/EnvelopeFileDocumentClassResponse"
          },
          "restrictedVisibilityRecipientIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The IDs of recipients with restricted visibility to this file, or null if not set.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Response containing details of an envelope file."
      },
      "EnvelopeFileDocumentClassResponse": {
        "required": [
          "id",
          "metadata"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The assigned document class ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The document class name, or null if none is assigned.",
            "nullable": true
          },
          "metadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/NumberFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/DateFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/ListOptionFileMetadataValueResponse"
                }
              ],
              "description": "A metadata field value of a file. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
            },
            "description": "The metadata field values for this file."
          }
        },
        "additionalProperties": false,
        "description": "Response containing the document class assigned to an envelope file."
      },
      "EnvelopeFileListResponse": {
        "required": [
          "files"
        ],
        "type": "object",
        "properties": {
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeFileResponse"
            },
            "description": "The list of files."
          }
        },
        "additionalProperties": false,
        "description": "List of files."
      },
      "EnvelopeFileResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The file ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000020"
          },
          "name": {
            "type": "string",
            "description": "The file name.",
            "example": "contract.pdf"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the file in the sequence.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Representation of a file."
      },
      "EnvelopeFileSummaryResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The file ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000020"
          },
          "name": {
            "type": "string",
            "description": "The file name.",
            "example": "contract.pdf"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The file sort order.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Summary of an envelope file."
      },
      "EnvelopeListResponse": {
        "required": [
          "envelopes",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "envelopes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeSummary"
            },
            "description": "The list of envelopes."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of envelopes."
      },
      "EnvelopeRecipientResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The recipient ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000100"
          },
          "languageCode": {
            "type": "string",
            "description": "The language code for the recipient's notifications.",
            "nullable": true,
            "example": "en-US"
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a recipient. Base for polymorphic response."
      },
      "EnvelopeReminderResponse": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "EnvelopeResponse": {
        "required": [
          "createdAt",
          "fileRestrictedVisibility",
          "files",
          "id",
          "qualifiedTimeStamp",
          "signatureFormat",
          "stages",
          "status",
          "updatedAt"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The envelope ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          },
          "name": {
            "type": "string",
            "description": "The envelope name.",
            "nullable": true,
            "example": "Contract for Mario Rossi"
          },
          "status": {
            "type": "string",
            "description": "The current status of the envelope.",
            "example": "Draft"
          },
          "createdAt": {
            "type": "string",
            "description": "When the envelope was created.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the envelope was last updated.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteEnvelopeExpirationResponse"
              },
              {
                "$ref": "#/components/schemas/RelativeEnvelopeExpirationResponse"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/EnvelopeReminderResponse"
          },
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeStageSummaryResponse"
            },
            "description": "The stages of the envelope."
          },
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeFileSummaryResponse"
            },
            "description": "The files of the envelope."
          },
          "sentAt": {
            "type": "string",
            "description": "When the envelope was sent.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-01-02T12:00:00Z"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the envelope must use a qualified timestamp server.",
            "example": true
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the envelope, or null.",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "statusChangeReason": {
            "type": "string",
            "description": "The reason for the envelope's terminal status change: the rejection reason when rejected, the cancellation reason when cancelled, otherwise null.",
            "nullable": true,
            "example": "Document no longer required"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language, or null when no custom agreements are configured.",
            "nullable": true
          },
          "fileRestrictedVisibility": {
            "type": "boolean",
            "description": "Whether file visibility is restricted per recipient.",
            "example": false
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the envelope.",
            "nullable": true,
            "example": "https://example.com/envelope-sent"
          },
          "bulkEnvelopeId": {
            "type": "string",
            "description": "The ID of the bulk envelope this envelope was generated from, or null when the caller has no access to it or it is not a bulk child.",
            "format": "uuid",
            "nullable": true,
            "example": "00000000-0000-0000-0000-000000000002"
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of an envelope."
      },
      "EnvelopeSortingKey": {
        "enum": [
          "LastUpdated",
          "Name"
        ],
        "type": "string",
        "description": "The available sorting keys for listing envelopes."
      },
      "EnvelopeStageAutomaticRecipientSummary": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeStageRecipientSummary"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "The friendly name of the eSealing signature profile used for automatic signing.",
                "nullable": true,
                "example": "default-eseal-profile"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Stage summary for an Automatic signer recipient."
      },
      "EnvelopeStageListResponse": {
        "required": [
          "stages"
        ],
        "type": "object",
        "properties": {
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeStageSummary"
            },
            "description": "The list of stages."
          }
        },
        "additionalProperties": false,
        "description": "List of stages."
      },
      "EnvelopeStageRecipientSummary": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The recipient ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000100"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a stage recipient. Base for polymorphic response."
      },
      "EnvelopeStageResponse": {
        "required": [
          "id",
          "name",
          "recipients",
          "requiredRecipientCompletions",
          "sortOrder",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Stage 1"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32",
            "example": 1
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "recipients": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/EnvelopeStageStandardRecipientSummary"
                },
                {
                  "$ref": "#/components/schemas/EnvelopeStageAutomaticRecipientSummary"
                }
              ],
              "description": "Summary representation of a stage recipient. Base for polymorphic response."
            },
            "description": "The recipients of the stage."
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a stage."
      },
      "EnvelopeStageSortOrder": {
        "required": [
          "id",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The new position of the stage.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Sort order entry for a stage."
      },
      "EnvelopeStageStandardRecipientSummary": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeStageRecipientSummary"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true,
                "example": "Mario"
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true,
                "example": "Rossi"
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true,
                "example": "mario.rossi@example.com"
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true,
                "example": "+39123456789"
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Stage summary for a Recipient recipient."
      },
      "EnvelopeStageSummary": {
        "required": [
          "id",
          "name",
          "requiredRecipientCompletions",
          "sortOrder",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Stage 1"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32",
            "example": 1
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a stage."
      },
      "EnvelopeStageSummaryResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000010"
          },
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Stage 1"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "Stage summary within an envelope response."
      },
      "EnvelopeStandardRecipientResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeRecipientResponse"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true,
                "example": "Mario"
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true,
                "example": "Rossi"
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true,
                "example": "mario.rossi@example.com"
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true,
                "example": "+39123456789"
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/RecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/RecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true,
                "example": "Please review and sign the attached contract."
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Detailed representation of a Recipient recipient.",
        "example": {
          "type": "Standard",
          "givenName": "Mario",
          "surname": "Rossi",
          "email": "mario.rossi@example.com",
          "phoneNumber": "+39123456789",
          "notificationChannels": [
            "Email"
          ],
          "personalMessage": "Please review and sign the attached contract.",
          "id": "00000000-0000-0000-0000-000000000100",
          "languageCode": "en-US"
        }
      },
      "EnvelopeStatusFilter": {
        "enum": [
          "Canceled",
          "Completed",
          "Draft",
          "Expired",
          "InProgress",
          "Rejected"
        ],
        "type": "string",
        "description": "The available status values for filtering envelopes."
      },
      "EnvelopeSummary": {
        "required": [
          "createdAt",
          "id",
          "name",
          "status",
          "updatedAt"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The envelope ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          },
          "name": {
            "type": "string",
            "description": "The envelope name.",
            "example": "Contract for Mario Rossi"
          },
          "status": {
            "type": "string",
            "description": "The current status of the envelope.",
            "example": "Draft"
          },
          "createdAt": {
            "type": "string",
            "description": "When the envelope was created.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the envelope was last updated.",
            "format": "date-time",
            "example": "2025-01-01T10:00:00Z"
          },
          "sentAt": {
            "type": "string",
            "description": "When the envelope was sent.",
            "format": "date-time",
            "nullable": true,
            "example": "2025-01-02T12:00:00Z"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of an envelope."
      },
      "EnvelopeWebhookListResponse": {
        "required": [
          "webhooks"
        ],
        "type": "object",
        "properties": {
          "webhooks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeWebhookSummary"
            },
            "description": "The webhooks configured on the envelope."
          }
        },
        "additionalProperties": false,
        "description": "List of envelope webhooks."
      },
      "EnvelopeWebhookResponse": {
        "required": [
          "createdAt",
          "event",
          "id",
          "updatedAt",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The webhook ID.",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls."
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "createdAt": {
            "type": "string",
            "description": "When the webhook was created.",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the webhook was last updated.",
            "format": "date-time"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of an envelope webhook."
      },
      "EnvelopeWebhookSummary": {
        "required": [
          "createdAt",
          "event",
          "id",
          "updatedAt",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The webhook ID.",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls."
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "createdAt": {
            "type": "string",
            "description": "When the webhook was created.",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the webhook was last updated.",
            "format": "date-time"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of an envelope webhook."
      },
      "ErrorResponse": {
        "required": [
          "errorId",
          "message",
          "messageEn"
        ],
        "type": "object",
        "properties": {
          "errorId": {
            "type": "string"
          },
          "field": {
            "type": "string",
            "nullable": true
          },
          "message": {},
          "messageEn": {},
          "additionalData": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ErrorsResponse": {
        "required": [
          "errors"
        ],
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "additionalProperties": false
      },
      "ExpirationMode": {
        "enum": [
          "Absolute",
          "Relative"
        ],
        "type": "string",
        "description": "The expiration mode of an envelope or template."
      },
      "FieldTask": {
        "required": [
          "field",
          "sortOrder",
          "source"
        ],
        "type": "object",
        "properties": {
          "field": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/SignatureField"
              },
              {
                "$ref": "#/components/schemas/TextInputField"
              },
              {
                "$ref": "#/components/schemas/CheckboxField"
              },
              {
                "$ref": "#/components/schemas/DropDownField"
              },
              {
                "$ref": "#/components/schemas/ListBoxField"
              },
              {
                "$ref": "#/components/schemas/AttachmentField"
              },
              {
                "$ref": "#/components/schemas/LinkField"
              },
              {
                "$ref": "#/components/schemas/FileReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/PageReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/AreaReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/ApprovalField"
              },
              {
                "$ref": "#/components/schemas/AnnotationField"
              },
              {
                "$ref": "#/components/schemas/RadioButtonField"
              },
              {
                "$ref": "#/components/schemas/InvisibleSignatureField"
              }
            ],
            "description": "The field definition."
          },
          "recipientId": {
            "type": "string",
            "description": "The ID of the recipient assigned to this task.",
            "format": "uuid",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the task in the sequence.",
            "format": "int32"
          },
          "source": {
            "$ref": "#/components/schemas/ElementSource"
          }
        },
        "additionalProperties": false,
        "description": "A task assigned to a field on a file."
      },
      "FieldTaskListResponse": {
        "required": [
          "tasks"
        ],
        "type": "object",
        "properties": {
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FieldTask"
            },
            "description": "The list of tasks."
          }
        },
        "additionalProperties": false,
        "description": "List of field tasks."
      },
      "FieldTaskRequest": {
        "required": [
          "field",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "field": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/SignatureField"
              },
              {
                "$ref": "#/components/schemas/TextInputField"
              },
              {
                "$ref": "#/components/schemas/CheckboxField"
              },
              {
                "$ref": "#/components/schemas/DropDownField"
              },
              {
                "$ref": "#/components/schemas/ListBoxField"
              },
              {
                "$ref": "#/components/schemas/AttachmentField"
              },
              {
                "$ref": "#/components/schemas/LinkField"
              },
              {
                "$ref": "#/components/schemas/FileReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/PageReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/AreaReadConfirmationField"
              },
              {
                "$ref": "#/components/schemas/ApprovalField"
              },
              {
                "$ref": "#/components/schemas/AnnotationField"
              },
              {
                "$ref": "#/components/schemas/RadioButtonField"
              },
              {
                "$ref": "#/components/schemas/InvisibleSignatureField"
              }
            ],
            "description": "The field definition."
          },
          "recipientId": {
            "type": "string",
            "description": "The ID of the recipient assigned to this task.",
            "format": "uuid",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the task in the sequence.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "A task assigned to a field on a file."
      },
      "FieldTaskType": {
        "enum": [
          "Signature",
          "TextInput",
          "Checkbox",
          "DropDown",
          "ListBox",
          "Attachment",
          "Link",
          "FileReadConfirmation",
          "PageReadConfirmation",
          "AreaReadConfirmation",
          "Approval",
          "InvisibleSignature",
          "Annotation",
          "RadioButton"
        ],
        "type": "string",
        "description": "The type of field task."
      },
      "FileMetadataValueResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A metadata field value of a file. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
      },
      "FileReadConfirmationField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "FileReadConfirmation"
            ],
            "type": "string",
            "default": "FileReadConfirmation"
          }
        },
        "description": "A file read confirmation field.",
        "example": {
          "fieldType": "FileReadConfirmation",
          "required": false,
          "id": "frc1"
        }
      },
      "FileSortOrder": {
        "required": [
          "id",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The file ID.",
            "format": "uuid"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The new position of the file.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Sort order entry for a file."
      },
      "FirstNameAnnotationValueFormat": {
        "required": [
          "annotationType"
        ],
        "type": "object",
        "properties": {
          "annotationType": {
            "enum": [
              "FirstName"
            ],
            "type": "string",
            "default": "FirstName"
          }
        },
        "additionalProperties": false,
        "description": "First name annotation value format."
      },
      "FontStyle": {
        "required": [
          "align",
          "bold",
          "color",
          "italic",
          "name",
          "size"
        ],
        "type": "object",
        "properties": {
          "size": {
            "type": "integer",
            "description": "The font size.",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "The font name."
          },
          "color": {
            "type": "string",
            "description": "The font color."
          },
          "align": {
            "$ref": "#/components/schemas/TextAlign"
          },
          "italic": {
            "type": "boolean",
            "description": "Whether the font is italic."
          },
          "bold": {
            "type": "boolean",
            "description": "Whether the font is bold."
          }
        },
        "additionalProperties": false,
        "description": "Font style configuration for a field."
      },
      "FullNameAnnotationValueFormat": {
        "required": [
          "annotationType"
        ],
        "type": "object",
        "properties": {
          "annotationType": {
            "enum": [
              "FullName"
            ],
            "type": "string",
            "default": "FullName"
          }
        },
        "additionalProperties": false,
        "description": "Full name annotation value format."
      },
      "GeneralSettings": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The organization's name.",
            "example": "name"
          }
        },
        "additionalProperties": false,
        "description": "The organization's general settings."
      },
      "GuidNullableOptionalNullable": {
        "required": [
          "isSet"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "IMandatoryAuthenticationOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationNone"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationAny"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationAccessCode"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationOneTimePassword"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationOAuth"
              }
            ],
            "description": "The organization's mandatory (forced) recipient authentication method. Discriminated by the\n`authentication` property: `\"None\"`, `\"Any\"`, `\"AccessCode\"`,\n`\"OneTimePassword\"`, `\"OAuth\"`.",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "InitialsAnnotationValueFormat": {
        "required": [
          "annotationType"
        ],
        "type": "object",
        "properties": {
          "annotationType": {
            "enum": [
              "Initials"
            ],
            "type": "string",
            "default": "Initials"
          }
        },
        "additionalProperties": false,
        "description": "Initials annotation value format."
      },
      "InvisibleSignatureField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "allowedSignatureTypes": {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/LocalCertificateSignature"
                    },
                    {
                      "$ref": "#/components/schemas/DisposableCertificateSignature"
                    },
                    {
                      "$ref": "#/components/schemas/RemoteCertificateSignature"
                    },
                    {
                      "$ref": "#/components/schemas/PluginSignature"
                    }
                  ],
                  "description": "Base invisible (CAdES, non-positional) signature type configuration."
                },
                "description": "The allowed signature types for this field.",
                "nullable": true
              },
              "qualifiedTimeStamp": {
                "type": "boolean",
                "description": "Whether the signature must use a qualified timestamp server.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "InvisibleSignature"
            ],
            "type": "string",
            "default": "InvisibleSignature"
          }
        },
        "description": "A CAdES (non-positional, document-level) signature field task.",
        "example": {
          "fieldType": "InvisibleSignature",
          "allowedSignatureTypes": [
            {
              "signatureType": "DisposableCertificateSignature"
            },
            {
              "signatureType": "LocalCertificateSignature"
            },
            {
              "signatureType": "PluginSignature",
              "pluginId": "ArubaGsp"
            },
            {
              "signatureType": "RemoteCertificateSignature"
            }
          ],
          "qualifiedTimeStamp": true,
          "id": "sig1"
        }
      },
      "LanguageListResponse": {
        "required": [
          "languages"
        ],
        "type": "object",
        "properties": {
          "languages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LanguageResponse"
            },
            "description": "The list of languages."
          }
        },
        "additionalProperties": false,
        "description": "List of available languages."
      },
      "LanguageResponse": {
        "required": [
          "code",
          "name"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The BCP 47 language code.",
            "example": "en"
          },
          "name": {
            "type": "string",
            "description": "The display name of the language.",
            "example": "English"
          }
        },
        "additionalProperties": false,
        "description": "A language available for selection."
      },
      "LanguageSettings": {
        "required": [
          "languages"
        ],
        "type": "object",
        "properties": {
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The language codes enabled for the organization, in alphabetical order."
          }
        },
        "additionalProperties": false,
        "description": "The organization's enabled languages."
      },
      "LastNameAnnotationValueFormat": {
        "required": [
          "annotationType"
        ],
        "type": "object",
        "properties": {
          "annotationType": {
            "enum": [
              "LastName"
            ],
            "type": "string",
            "default": "LastName"
          }
        },
        "additionalProperties": false,
        "description": "Last name annotation value format."
      },
      "LinkField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "reference": {
                "type": "string",
                "description": "The Reference of the link.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "Link"
            ],
            "type": "string",
            "default": "Link"
          }
        },
        "description": "A link field.",
        "example": {
          "fieldType": "Link",
          "reference": "https://example.com",
          "positionX": 50,
          "positionY": 700,
          "width": 150,
          "height": 30,
          "page": 1,
          "id": "lnk1"
        }
      },
      "ListBoxField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "font": {
                "$ref": "#/components/schemas/FontStyle"
              },
              "options": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Option"
                },
                "description": "The list of options.",
                "nullable": true
              },
              "multiselect": {
                "type": "boolean",
                "description": "Whether multiple options can be selected."
              },
              "readOnly": {
                "type": "boolean",
                "description": "Whether the field is read-only."
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "ListBox"
            ],
            "type": "string",
            "default": "ListBox"
          }
        },
        "description": "A list box field.",
        "example": {
          "fieldType": "ListBox",
          "font": {
            "size": 12,
            "name": "Helvetica",
            "color": "#000000",
            "align": "Left",
            "italic": false,
            "bold": false
          },
          "options": [
            {
              "key": "val1",
              "value": "Label 1",
              "selected": false
            },
            {
              "key": "val2",
              "value": "Label 2",
              "selected": true
            }
          ],
          "multiselect": true,
          "readOnly": false,
          "required": false,
          "positionX": 50,
          "positionY": 500,
          "width": 150,
          "height": 80,
          "page": 1,
          "id": "lb1"
        }
      },
      "ListOptionDocumentClassMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentClassMetadataResponse"
          },
          {
            "type": "object",
            "properties": {
              "options": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DocumentMetadataOptionItem"
                },
                "description": "The predefined selectable options.",
                "nullable": true
              },
              "parentId": {
                "type": "string",
                "description": "The ID of the parent metadata field this field depends on, when defined.",
                "format": "uuid",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "A document class metadata field carrying a predefined list of selectable options.",
        "example": {
          "options": [
            {
              "id": "5f122cda-33a6-4739-826f-325232fd46c6",
              "value": "Invoice",
              "parentId": "d37041eb-c544-4c76-a7c3-036510ab7c46"
            },
            {
              "id": "8283318b-1c11-4226-a836-4a299a284241",
              "value": "NDA"
            }
          ],
          "parentId": "543053b6-f157-4cc8-a5ff-e8aaa3431cf7",
          "type": "ListOptionType",
          "id": "4dcc5e5e-dfc9-4dbd-9c41-7505becc470d",
          "name": "ContractType",
          "required": true,
          "sortOrder": 4
        }
      },
      "ListOptionDocumentMetadataItem": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentMetadataItem"
          },
          {
            "type": "object",
            "properties": {
              "parentId": {
                "type": "string",
                "description": "The ID of the parent metadata field this field depends on, when defined.",
                "format": "uuid",
                "nullable": true
              },
              "options": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DocumentMetadataOptionItem"
                },
                "description": "The predefined selectable options.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "An organization-level document metadata field of type `MetadataValueType.ListOptionType`.",
        "example": {
          "parentId": "18eb3dde-4e35-4c62-b967-ed2749bb5a86",
          "options": [
            {
              "id": "090ea74a-6ec9-48cf-9ba9-c4bcc942adc4",
              "value": "Invoice",
              "parentId": "68fd57fe-9ccc-4093-bbf2-df600972880d"
            },
            {
              "id": "c8fad119-b9ca-45a7-a7f4-8b10a2df2cc4",
              "value": "NDA"
            }
          ],
          "type": "ListOptionType",
          "id": "ae3df14a-38f7-4a15-a83b-67e24377ad6c",
          "name": "ContractType"
        }
      },
      "ListOptionFileMetadataValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/FileMetadataValueResponse"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The ID of the selected option, or null if not set.",
                "format": "uuid",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "A list option metadata value of a file.",
        "example": {
          "value": "211e1b27-0e46-4ff5-96fa-a8d9edd1145e",
          "type": "ListOptionType",
          "id": "1009bc97-23ea-4bf6-b931-1a7542064965",
          "name": "ContractType"
        }
      },
      "ListOptionMetadataValueRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/MetadataValueRequest"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The ID of the selected option, or `null` to clear the field.",
                "format": "uuid",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "A metadata value carrying one option selected from a predefined, per-field set of allowed options."
      },
      "ListOptionPolicyConditionMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataRequest"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The comparison list option id (not its display text/label).",
                "format": "uuid"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "A policy condition's comparison value for a list-option-type metadata field."
      },
      "ListOptionPolicyConditionValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataResponse"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The comparison list option id (not its display text/label).",
                "format": "uuid"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "A policy condition's comparison value for a list-option-type metadata field."
      },
      "LocalCertificateSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "LocalCertificateSignature"
            ],
            "type": "string",
            "default": "LocalCertificateSignature"
          }
        },
        "additionalProperties": false,
        "description": "Local certificate signature configuration.",
        "example": {
          "signatureType": "LocalCertificateSignature"
        }
      },
      "MandatoryAuthenticationAccessCode": {
        "required": [
          "authentication"
        ],
        "type": "object",
        "properties": {
          "authentication": {
            "enum": [
              "AccessCode"
            ],
            "type": "string",
            "default": "AccessCode"
          }
        },
        "additionalProperties": false,
        "description": "Access code authentication is mandatory."
      },
      "MandatoryAuthenticationAny": {
        "required": [
          "authentication"
        ],
        "type": "object",
        "properties": {
          "authentication": {
            "enum": [
              "Any"
            ],
            "type": "string",
            "default": "Any"
          }
        },
        "additionalProperties": false,
        "description": "Any authentication method may be used to satisfy the mandatory authentication requirement."
      },
      "MandatoryAuthenticationNone": {
        "required": [
          "authentication"
        ],
        "type": "object",
        "properties": {
          "authentication": {
            "enum": [
              "None"
            ],
            "type": "string",
            "default": "None"
          }
        },
        "additionalProperties": false,
        "description": "No mandatory authentication method is enforced."
      },
      "MandatoryAuthenticationOAuth": {
        "required": [
          "authentication",
          "oAuthProviderId"
        ],
        "type": "object",
        "properties": {
          "authentication": {
            "enum": [
              "OAuth"
            ],
            "type": "string",
            "default": "OAuth"
          },
          "oAuthProviderId": {
            "type": "string",
            "description": "The external ID of the OAuth provider that must be used, from `GET /settings/oauth-providers`.",
            "format": "uuid",
            "example": "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
          }
        },
        "additionalProperties": false,
        "description": "OAuth authentication with a specific provider is mandatory."
      },
      "MandatoryAuthenticationOneTimePassword": {
        "required": [
          "authentication"
        ],
        "type": "object",
        "properties": {
          "authentication": {
            "enum": [
              "OneTimePassword"
            ],
            "type": "string",
            "default": "OneTimePassword"
          }
        },
        "additionalProperties": false,
        "description": "One-time password authentication is mandatory."
      },
      "MandatoryAuthenticationType": {
        "enum": [
          "None",
          "Any",
          "AccessCode",
          "OneTimePassword",
          "OAuth"
        ],
        "type": "string",
        "description": "The mandatory authentication method values supported by the `authentication` discriminator."
      },
      "MetadataValueRequest": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "A metadata field value. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
      },
      "MetadataValueType": {
        "enum": [
          "StringType",
          "NumberType",
          "DateType",
          "ListOptionType"
        ],
        "type": "string",
        "description": "The data type of a document-class metadata field value, used as the `type` discriminator."
      },
      "NextRecipientDto": {
        "required": [
          "givenName",
          "id",
          "surname",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The recipient ID.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000100"
          },
          "givenName": {
            "type": "string",
            "description": "The recipient's given name.",
            "example": "Mario"
          },
          "surname": {
            "type": "string",
            "description": "The recipient's surname.",
            "example": "Rossi"
          },
          "type": {
            "$ref": "#/components/schemas/NextRecipientType"
          }
        },
        "additionalProperties": false,
        "description": "Represents a next recipient in the signing workflow."
      },
      "NextRecipientLinkDto": {
        "required": [
          "link",
          "recipient"
        ],
        "type": "object",
        "properties": {
          "recipient": {
            "$ref": "#/components/schemas/NextRecipientDto"
          },
          "link": {
            "type": "string",
            "description": "The action link for the recipient.",
            "example": "https://sign.example.com/recipient/00000000-0000-0000-0000-000000000100"
          }
        },
        "additionalProperties": false,
        "description": "Represents a next recipient with their action link."
      },
      "NextRecipientLinksResponse": {
        "required": [
          "nextRecipientLinks"
        ],
        "type": "object",
        "properties": {
          "nextRecipientLinks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NextRecipientLinkDto"
            },
            "description": "The list of next recipient links."
          }
        },
        "additionalProperties": false,
        "description": "Response containing next recipient links."
      },
      "NextRecipientType": {
        "enum": [
          "Signer",
          "Automatic",
          "Approver",
          "Viewer"
        ],
        "type": "string",
        "description": "Type of next recipient in the signing workflow."
      },
      "NotificationChannel": {
        "enum": [
          "None",
          "Email",
          "Sms",
          "WhatsApp"
        ],
        "type": "string",
        "description": "The notification delivery channel."
      },
      "NumberDocumentClassMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentClassMetadataResponse"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "A document class metadata field carrying a numeric value.",
        "example": {
          "type": "NumberType",
          "id": "4a44beaa-2c32-43d0-8130-00bb8e2b1cb0",
          "name": "TotalAmount",
          "required": true,
          "sortOrder": 2
        }
      },
      "NumberDocumentMetadataItem": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentMetadataItem"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "An organization-level document metadata field of type `MetadataValueType.NumberType`.",
        "example": {
          "type": "NumberType",
          "id": "d481d30e-37b2-4e94-942b-82ee7d110866",
          "name": "TotalAmount"
        }
      },
      "NumberFileMetadataValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/FileMetadataValueResponse"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "description": "The numeric value, or null if not set.",
                "format": "double",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "A numeric (decimal) metadata value of a file.",
        "example": {
          "value": 100.9,
          "type": "NumberType",
          "id": "2f4d9262-560a-49ee-a49b-d6364364971f",
          "name": "Amount"
        }
      },
      "NumberInputConfig": {
        "required": [
          "decimalPlaces",
          "decimalSeparator",
          "textInputType",
          "thousandsSeparator"
        ],
        "type": "object",
        "properties": {
          "textInputType": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          },
          "value": {
            "type": "number",
            "description": "The numeric value.",
            "format": "double",
            "nullable": true
          },
          "thousandsSeparator": {
            "$ref": "#/components/schemas/ThousandsSeparator"
          },
          "decimalSeparator": {
            "$ref": "#/components/schemas/DecimalSeparator"
          },
          "symbol": {
            "$ref": "#/components/schemas/NumberSymbol"
          },
          "decimalPlaces": {
            "type": "integer",
            "description": "The number of decimal places.",
            "format": "int32"
          },
          "minValue": {
            "type": "number",
            "description": "The minimum allowed value.",
            "format": "double",
            "nullable": true
          },
          "maxValue": {
            "type": "number",
            "description": "The maximum allowed value.",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Configuration for a number text input.",
        "example": {
          "textInputType": "NumberType",
          "value": 42.51,
          "thousandsSeparator": "Point",
          "decimalSeparator": "Comma",
          "symbol": {
            "value": "€",
            "position": "Start"
          },
          "decimalPlaces": 2,
          "minValue": 10.25,
          "maxValue": 1000.78
        }
      },
      "NumberMetadataValueRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/MetadataValueRequest"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "description": "The numeric value.",
                "format": "double"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "A metadata value carrying a numeric (decimal) payload."
      },
      "NumberPolicyConditionMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataRequest"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "description": "The comparison numeric value.",
                "format": "double"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "A policy condition's comparison value for a number-type metadata field."
      },
      "NumberPolicyConditionValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataResponse"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "description": "The comparison numeric value.",
                "format": "double"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "A policy condition's comparison value for a number-type metadata field."
      },
      "NumberSymbol": {
        "required": [
          "position"
        ],
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "The currency or unit symbol value.",
            "nullable": true
          },
          "position": {
            "$ref": "#/components/schemas/SymbolPosition"
          }
        },
        "additionalProperties": false,
        "description": "The currency or unit symbol of a number input and its position."
      },
      "OAuthAuthentication": {
        "type": "object",
        "properties": {
          "providerName": {
            "type": "string",
            "description": "The OAuth provider name.",
            "nullable": true
          },
          "id": {
            "type": "string",
            "description": "The identifier of the OAuth provider.",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "OAuth authentication configuration."
      },
      "OAuthProviderListResponse": {
        "required": [
          "oAuthProviders",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "oAuthProviders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OAuthProviderSummary"
            },
            "description": "The list of OAuth providers."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of OAuth providers."
      },
      "OAuthProviderSummary": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The OAuth provider identifier.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The display name of the OAuth provider."
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of an OAuth provider."
      },
      "OneTimePasswordAuthenticationChannel": {
        "enum": [
          "Sms"
        ],
        "type": "string",
        "description": "Delivery channel used to send the OTP for recipient authentication."
      },
      "OneTimePasswordSettings": {
        "required": [
          "enabled"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether one time password authentication is enabled."
          }
        },
        "additionalProperties": false,
        "description": "The one-time password authentication configuration."
      },
      "OneTimePasswordSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "OneTimePasswordSignature"
            ],
            "type": "string",
            "default": "OneTimePasswordSignature"
          }
        },
        "additionalProperties": false,
        "description": "One-time password signature configuration.",
        "example": {
          "signatureType": "OneTimePasswordSignature"
        }
      },
      "Option": {
        "required": [
          "key",
          "selected",
          "value"
        ],
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The option key."
          },
          "value": {
            "type": "string",
            "description": "The option value."
          },
          "selected": {
            "type": "boolean",
            "description": "Whether the option is selected."
          }
        },
        "additionalProperties": false,
        "description": "An option for a selectable field."
      },
      "OrganizationWebhookListResponse": {
        "required": [
          "webhooks"
        ],
        "type": "object",
        "properties": {
          "webhooks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrganizationWebhookSummary"
            },
            "description": "The webhooks configured on the organization."
          }
        },
        "additionalProperties": false,
        "description": "List of organization webhooks."
      },
      "OrganizationWebhookResponse": {
        "required": [
          "createdAt",
          "event",
          "id",
          "updatedAt",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The webhook ID.",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls."
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "createdAt": {
            "type": "string",
            "description": "When the webhook was created.",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the webhook was last updated.",
            "format": "date-time"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of an organization webhook."
      },
      "OrganizationWebhookSummary": {
        "required": [
          "createdAt",
          "event",
          "id",
          "updatedAt",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The webhook ID.",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls."
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "createdAt": {
            "type": "string",
            "description": "When the webhook was created.",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the webhook was last updated.",
            "format": "date-time"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of an organization webhook."
      },
      "OtpDeliveryChannel": {
        "enum": [
          "Sms",
          "Email"
        ],
        "type": "string",
        "description": "Delivery channel used to send the OTP to the recipient."
      },
      "OtpSignature": {
        "type": "object",
        "properties": {
          "channel": {
            "$ref": "#/components/schemas/OtpDeliveryChannel"
          }
        },
        "additionalProperties": false,
        "description": "OTP signature configuration."
      },
      "PageReadConfirmationField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "PageReadConfirmation"
            ],
            "type": "string",
            "default": "PageReadConfirmation"
          }
        },
        "description": "A page read confirmation field.",
        "example": {
          "fieldType": "PageReadConfirmation",
          "required": false,
          "page": 1,
          "id": "prc1"
        }
      },
      "PaginationResponse": {
        "required": [
          "page",
          "pageSize",
          "totalCount"
        ],
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "description": "The current page number.",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "description": "The number of items per page.",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "description": "The total number of items.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Pagination metadata."
      },
      "PatchBulkEnvelopeFilesRequest": {
        "required": [
          "files"
        ],
        "type": "object",
        "properties": {
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FileSortOrder"
            },
            "description": "The new file ordering."
          }
        },
        "additionalProperties": false,
        "description": "Request body for reordering bulk envelope files."
      },
      "PatchBulkEnvelopeStagesRequest": {
        "required": [
          "stages"
        ],
        "type": "object",
        "properties": {
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeStageSortOrder"
            },
            "description": "The new stage ordering."
          }
        },
        "additionalProperties": false,
        "description": "Request body for reordering bulk envelope stages."
      },
      "PatchEnvelopeFilesRequest": {
        "required": [
          "files"
        ],
        "type": "object",
        "properties": {
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FileSortOrder"
            },
            "description": "The new file ordering."
          }
        },
        "additionalProperties": false,
        "description": "Request body for reordering files."
      },
      "PatchEnvelopeStagesRequest": {
        "required": [
          "stages"
        ],
        "type": "object",
        "properties": {
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnvelopeStageSortOrder"
            },
            "description": "The new stage ordering."
          }
        },
        "additionalProperties": false,
        "description": "Request body for reordering stages."
      },
      "PatchTemplateFilesRequest": {
        "required": [
          "files"
        ],
        "type": "object",
        "properties": {
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FileSortOrder"
            },
            "description": "The new file ordering."
          }
        },
        "additionalProperties": false,
        "description": "Request body for reordering files."
      },
      "PatchTemplateStagesRequest": {
        "required": [
          "stages"
        ],
        "type": "object",
        "properties": {
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TemplateStageSortOrder"
            },
            "description": "The new stage ordering."
          }
        },
        "additionalProperties": false,
        "description": "Request body for reordering stages."
      },
      "Permission": {
        "required": [
          "action",
          "entity"
        ],
        "type": "object",
        "properties": {
          "entity": {
            "$ref": "#/components/schemas/PermissionEntity"
          },
          "action": {
            "$ref": "#/components/schemas/PermissionAction"
          }
        },
        "additionalProperties": false,
        "description": "A single entity/action permission pair granted by an application role."
      },
      "PermissionAction": {
        "enum": [
          "Read",
          "Write"
        ],
        "type": "string",
        "description": "The action an application role permission grants on an entity."
      },
      "PermissionEntity": {
        "enum": [
          "Envelope",
          "Template",
          "Organization",
          "User",
          "UserGroup"
        ],
        "type": "string",
        "description": "The domain entity an application role permission applies to."
      },
      "PhoneNumberInputConfig": {
        "required": [
          "format",
          "textInputType",
          "value"
        ],
        "type": "object",
        "properties": {
          "textInputType": {
            "enum": [
              "PhoneNumberType"
            ],
            "type": "string",
            "default": "PhoneNumberType"
          },
          "value": {
            "type": "string",
            "description": "The phone number value."
          },
          "format": {
            "$ref": "#/components/schemas/PhoneType"
          }
        },
        "additionalProperties": false,
        "description": "Configuration for a phone number text input.",
        "example": {
          "textInputType": "PhoneNumberType",
          "value": "+393331234567",
          "format": "InternationalLeadingPlus"
        }
      },
      "PhoneType": {
        "enum": [
          "International",
          "InternationalLeadingZeros",
          "InternationalLeadingPlus"
        ],
        "type": "string",
        "description": "The phone number display format of a phone number text input."
      },
      "PluginSignature": {
        "required": [
          "pluginId",
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "pluginId": {
            "type": "string",
            "description": "The plugin ID."
          },
          "signatureType": {
            "enum": [
              "PluginSignature"
            ],
            "type": "string",
            "default": "PluginSignature"
          }
        },
        "additionalProperties": false,
        "description": "Plugin signature configuration.",
        "example": {
          "pluginId": "ArubaGsp",
          "signatureType": "PluginSignature"
        }
      },
      "PolicyActionRequest": {
        "required": [
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "sortOrder": {
            "type": "integer",
            "description": "The action's position within the policy. Must start at 1, be unique, and contiguous within the actions list.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "A single action within a policy request. Discriminated by the `type` property."
      },
      "PolicyActionResponse": {
        "required": [
          "id",
          "recipientSource",
          "sortOrder",
          "stage",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The action ID.",
            "format": "uuid"
          },
          "type": {
            "$ref": "#/components/schemas/PolicyActionType"
          },
          "stage": {
            "$ref": "#/components/schemas/StageConfigurationResponse"
          },
          "recipientSource": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/StaticPolicyRecipientSourceResponse"
              },
              {
                "$ref": "#/components/schemas/DynamicPolicyRecipientSourceResponse"
              }
            ],
            "description": "The action's recipient source, discriminated by the `type` property."
          },
          "sortOrder": {
            "type": "integer",
            "description": "The action's position within the policy.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "A single action within a policy."
      },
      "PolicyActionType": {
        "enum": [
          "AddEnvelopeStageConfiguration"
        ],
        "type": "string",
        "description": "The kind of action performed by a policy."
      },
      "PolicyConditionMetadataRequest": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The document metadata field ID this condition evaluates.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "A policy condition's metadata field and comparison value. Discriminated by the `type` property."
      },
      "PolicyConditionMetadataResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The document metadata field ID this condition evaluates.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "A policy condition's metadata field and comparison value. Discriminated by the `type` property."
      },
      "PolicyConditionOperator": {
        "enum": [
          "GreaterThan",
          "LessThan",
          "Equals"
        ],
        "type": "string",
        "description": "The comparison operator applied by a policy condition."
      },
      "PolicyConditionRequest": {
        "required": [
          "metadata",
          "operator",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "operator": {
            "$ref": "#/components/schemas/PolicyConditionOperator"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The condition's position within the policy. Must start at 1, be unique, and contiguous within the conditions list.",
            "format": "int32",
            "example": 1
          },
          "metadata": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/StringPolicyConditionMetadataRequest"
              },
              {
                "$ref": "#/components/schemas/NumberPolicyConditionMetadataRequest"
              },
              {
                "$ref": "#/components/schemas/DatePolicyConditionMetadataRequest"
              },
              {
                "$ref": "#/components/schemas/ListOptionPolicyConditionMetadataRequest"
              }
            ],
            "description": "The document metadata field this condition evaluates, and its comparison value, discriminated by the `type` property."
          }
        },
        "additionalProperties": false,
        "description": "A single condition within a policy request."
      },
      "PolicyConditionResponse": {
        "required": [
          "id",
          "metadata",
          "operator",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The condition ID.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          },
          "operator": {
            "$ref": "#/components/schemas/PolicyConditionOperator"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The condition's position within the policy.",
            "format": "int32",
            "example": 1
          },
          "metadata": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/StringPolicyConditionValueResponse"
              },
              {
                "$ref": "#/components/schemas/NumberPolicyConditionValueResponse"
              },
              {
                "$ref": "#/components/schemas/DatePolicyConditionValueResponse"
              },
              {
                "$ref": "#/components/schemas/ListOptionPolicyConditionValueResponse"
              }
            ],
            "description": "The document metadata field this condition evaluates, and its comparison value, discriminated by the `type` property."
          }
        },
        "additionalProperties": false,
        "description": "A single condition within a policy."
      },
      "PolicyListResponse": {
        "required": [
          "pagination",
          "policies"
        ],
        "type": "object",
        "properties": {
          "policies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicySummary"
            },
            "description": "The list of policies."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of policies."
      },
      "PolicyRecipientRequest": {
        "required": [
          "email",
          "givenName",
          "surname"
        ],
        "type": "object",
        "properties": {
          "givenName": {
            "type": "string",
            "description": "The recipient's given name."
          },
          "surname": {
            "type": "string",
            "description": "The recipient's surname."
          },
          "email": {
            "type": "string",
            "description": "The recipient's email address."
          },
          "phoneNumber": {
            "type": "string",
            "description": "The recipient's phone number.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A recipient of a static policy recipient source."
      },
      "PolicyRecipientResponse": {
        "required": [
          "email",
          "givenName",
          "surname"
        ],
        "type": "object",
        "properties": {
          "givenName": {
            "type": "string",
            "description": "The recipient's given name."
          },
          "surname": {
            "type": "string",
            "description": "The recipient's surname."
          },
          "email": {
            "type": "string",
            "description": "The recipient's email address."
          },
          "phoneNumber": {
            "type": "string",
            "description": "The recipient's phone number.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A recipient of a static policy recipient source."
      },
      "PolicyRecipientSourceRequest": {
        "type": "object",
        "additionalProperties": false,
        "description": "A policy action's recipient source, discriminated by the `type` property."
      },
      "PolicyRecipientSourceType": {
        "enum": [
          "Static",
          "Dynamic"
        ],
        "type": "string",
        "description": "The kind of recipient source applied by a policy action."
      },
      "PolicyResponse": {
        "required": [
          "actions",
          "conditions",
          "id",
          "isActive",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The policy ID.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          },
          "name": {
            "type": "string",
            "description": "The policy name.",
            "example": "Standard signing policy"
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether the policy is active.",
            "example": true
          },
          "description": {
            "type": "string",
            "description": "The policy description.",
            "nullable": true,
            "example": "Policy applied to all standard signing envelopes"
          },
          "documentClassId": {
            "type": "string",
            "description": "The document class this policy applies to, when set.",
            "format": "uuid",
            "nullable": true
          },
          "conditions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyConditionResponse"
            },
            "description": "The policy's conditions."
          },
          "actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyActionResponse"
            },
            "description": "The policy's actions."
          }
        },
        "additionalProperties": false,
        "description": "Full representation of a policy, including its conditions and actions."
      },
      "PolicySortingKey": {
        "enum": [
          "Name",
          "Description",
          "IsActive"
        ],
        "type": "string",
        "description": "The available sorting keys for listing policies."
      },
      "PolicySummary": {
        "required": [
          "id",
          "isActive",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The policy ID.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          },
          "name": {
            "type": "string",
            "description": "The policy name.",
            "example": "Standard signing policy"
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether the policy is active.",
            "example": true
          },
          "description": {
            "type": "string",
            "description": "The policy description.",
            "nullable": true,
            "example": "Policy applied to all standard signing envelopes"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a policy."
      },
      "RadioButtonField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "groupName": {
                "type": "string",
                "description": "The group name for the radio button.",
                "nullable": true
              },
              "checked": {
                "type": "boolean",
                "description": "Whether the radio button is checked."
              },
              "readOnly": {
                "type": "boolean",
                "description": "Whether the radio button is read-only."
              },
              "value": {
                "type": "string",
                "description": "The value of the radio button.",
                "nullable": true
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "RadioButton"
            ],
            "type": "string",
            "default": "RadioButton"
          }
        },
        "description": "A radio button field.",
        "example": {
          "fieldType": "RadioButton",
          "groupName": "group1",
          "checked": false,
          "readOnly": false,
          "value": "option1",
          "required": true,
          "positionX": 100,
          "positionY": 200,
          "width": 20,
          "height": 20,
          "page": 1,
          "id": "rb1"
        }
      },
      "RecipientAuthentication": {
        "type": "object",
        "properties": {
          "accessCode": {
            "$ref": "#/components/schemas/AccessCode"
          },
          "oneTimePassword": {
            "$ref": "#/components/schemas/AuthenticationOneTimePassword"
          },
          "oAuthAuthentications": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OAuthAuthentication"
            },
            "description": "OAuth authentications.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Recipient authentication configuration."
      },
      "RecipientAuthenticationSettings": {
        "required": [
          "accessCode"
        ],
        "type": "object",
        "properties": {
          "accessCode": {
            "type": "boolean",
            "description": "Whether access code authentication is enabled."
          },
          "oneTimePassword": {
            "$ref": "#/components/schemas/OneTimePasswordSettings"
          }
        },
        "additionalProperties": false,
        "description": "The organization's recipient authentication settings."
      },
      "RecipientDelegation": {
        "enum": [
          "notAllowed",
          "allowedDisabled",
          "allowedEnabled"
        ],
        "type": "string",
        "description": "The recipient delegation policies supported by the settings/recipient endpoint."
      },
      "RecipientDelegationOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/RecipientDelegation"
          }
        },
        "additionalProperties": false
      },
      "RecipientMetadataEntry": {
        "required": [
          "name",
          "value"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The metadata key (used as the XML element name when injected into the workstep).",
            "example": "CustomText"
          },
          "value": {
            "type": "string",
            "description": "The metadata value (used as the XML element value when injected into the workstep).",
            "example": "Mario Rossi"
          }
        },
        "additionalProperties": false,
        "description": "A single recipient metadata entry, expressed as a name/value pair."
      },
      "RecipientSettings": {
        "required": [
          "authentications",
          "mandatoryAuthentication",
          "recipientDelegation",
          "sendCompletedFileToAllRecipients",
          "warnIfRecipientsHaveNoFields"
        ],
        "type": "object",
        "properties": {
          "sendCompletedFileToAllRecipients": {
            "type": "boolean",
            "description": "Whether the completed file is sent to all recipients."
          },
          "warnIfRecipientsHaveNoFields": {
            "type": "boolean",
            "description": "Whether a warning is shown when some recipients have no fields."
          },
          "authentications": {
            "$ref": "#/components/schemas/RecipientAuthenticationSettings"
          },
          "recipientDelegation": {
            "$ref": "#/components/schemas/RecipientDelegation"
          },
          "mandatoryAuthentication": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationNone"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationAny"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationAccessCode"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationOneTimePassword"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationOAuth"
              }
            ],
            "description": "The organization's mandatory (forced) recipient authentication method."
          }
        },
        "additionalProperties": false,
        "description": "The organization's recipient settings."
      },
      "RecipientSignatureData": {
        "type": "object",
        "properties": {
          "disposableCertificate": {
            "$ref": "#/components/schemas/DisposableCertificate"
          },
          "remoteCertificate": {
            "$ref": "#/components/schemas/RemoteCertificateDto"
          },
          "otpSignature": {
            "$ref": "#/components/schemas/OtpSignature"
          },
          "signingPlugins": {
            "$ref": "#/components/schemas/SigningPlugins"
          }
        },
        "additionalProperties": false,
        "description": "Signature configuration for a recipient."
      },
      "RecipientType": {
        "enum": [
          "Standard",
          "Automatic"
        ],
        "type": "string",
        "description": "Possible kinds of recipient"
      },
      "RegionalDefaultsSettings": {
        "required": [
          "dateTimeFormat",
          "language",
          "timeZone"
        ],
        "type": "object",
        "properties": {
          "timeZone": {
            "type": "string",
            "description": "The organization's default IANA time zone identifier.",
            "example": "Europe/Berlin"
          },
          "dateTimeFormat": {
            "type": "string",
            "description": "The organization's default date and time display format.",
            "example": "dd/MM/yyyy | HH:mm"
          },
          "language": {
            "type": "string",
            "description": "The organization's default language code.",
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "The organization's regional defaults."
      },
      "RelativeBulkEnvelopeExpirationResponse": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the bulk envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration."
      },
      "RelativeCreateBulkEnvelopeExpiration": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the bulk envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration."
      },
      "RelativeCreateEnvelopeExpiration": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration.",
        "example": {
          "afterSendInSeconds": 604800,
          "mode": "Relative"
        }
      },
      "RelativeCreateTemplateExpiration": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration.",
        "example": {
          "afterSendInSeconds": 604800,
          "mode": "Relative"
        }
      },
      "RelativeEnvelopeExpirationResponse": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration."
      },
      "RelativeTemplateExpirationResponse": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the envelope expires.",
            "format": "int64",
            "nullable": true
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration."
      },
      "RelativeUpdateBulkEnvelopeExpirationRequest": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the bulk envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration."
      },
      "RelativeUpdateEnvelopeExpirationRequest": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration.",
        "example": {
          "afterSendInSeconds": 604800,
          "mode": "Relative"
        }
      },
      "RelativeUpdateTemplateExpirationRequest": {
        "required": [
          "mode"
        ],
        "type": "object",
        "properties": {
          "afterSendInSeconds": {
            "type": "integer",
            "description": "Seconds after sending before the envelope expires.",
            "format": "int64",
            "nullable": true,
            "example": 604800
          },
          "mode": {
            "enum": [
              "Relative"
            ],
            "type": "string",
            "default": "Relative"
          }
        },
        "additionalProperties": false,
        "description": "Relative expiration configuration.",
        "example": {
          "afterSendInSeconds": 604800,
          "mode": "Relative"
        }
      },
      "RemoteCertificateDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "description": "The user ID.",
            "nullable": true
          },
          "deviceId": {
            "type": "string",
            "description": "The device ID.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Remote certificate configuration."
      },
      "RemoteCertificateSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "RemoteCertificateSignature"
            ],
            "type": "string",
            "default": "RemoteCertificateSignature"
          }
        },
        "additionalProperties": false,
        "description": "Remote certificate signature configuration.",
        "example": {
          "signatureType": "RemoteCertificateSignature"
        }
      },
      "ResumeEnvelopeRequest": {
        "required": [
          "newExpirationDate"
        ],
        "type": "object",
        "properties": {
          "newExpirationDate": {
            "type": "string",
            "description": "The new expiration date for the resumed envelope.",
            "format": "date-time",
            "example": "2025-12-31T23:59:59Z"
          }
        },
        "additionalProperties": false,
        "description": "Request body for resuming an expired envelope."
      },
      "SignatureField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "allowedSignatureTypes": {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ClickToSignSignature"
                    },
                    {
                      "$ref": "#/components/schemas/DrawToSignSignature"
                    },
                    {
                      "$ref": "#/components/schemas/TypeToSignSignature"
                    },
                    {
                      "$ref": "#/components/schemas/LocalCertificateSignature"
                    },
                    {
                      "$ref": "#/components/schemas/DisposableCertificateSignature"
                    },
                    {
                      "$ref": "#/components/schemas/BiometricSignature"
                    },
                    {
                      "$ref": "#/components/schemas/RemoteCertificateSignature"
                    },
                    {
                      "$ref": "#/components/schemas/OneTimePasswordSignature"
                    },
                    {
                      "$ref": "#/components/schemas/PluginSignature"
                    },
                    {
                      "$ref": "#/components/schemas/AutomaticSignature"
                    }
                  ],
                  "description": "Base signature type configuration."
                },
                "description": "The allowed signature types for this field.",
                "nullable": true
              },
              "qualifiedTimeStamp": {
                "type": "boolean",
                "description": "Whether the signature must use a qualified timestamp server. Optional. When omitted, the value `false` is applied at the downstream Nova boundary.",
                "nullable": true,
                "example": true
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              },
              "batchGroup": {
                "type": "string",
                "description": "The optional batch-signing group this field belongs to.",
                "nullable": true,
                "example": "group1"
              },
              "layoutId": {
                "type": "string",
                "description": "The optional identifier of the signature layout applied to this field, one of the organization's signature layouts. When omitted, the organization default layout is used.",
                "format": "uuid",
                "nullable": true,
                "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "Signature"
            ],
            "type": "string",
            "default": "Signature"
          }
        },
        "description": "A signature field.",
        "example": {
          "fieldType": "Signature",
          "allowedSignatureTypes": [
            {
              "signatureType": "BiometricSignature"
            },
            {
              "signatureType": "ClickToSignSignature"
            },
            {
              "signatureType": "DisposableCertificateSignature"
            },
            {
              "signatureType": "DrawToSignSignature"
            },
            {
              "signatureType": "LocalCertificateSignature"
            },
            {
              "signatureType": "OneTimePasswordSignature"
            },
            {
              "signatureType": "PluginSignature",
              "pluginId": "ArubaGsp"
            },
            {
              "signatureType": "RemoteCertificateSignature"
            },
            {
              "signatureType": "TypeToSignSignature"
            }
          ],
          "qualifiedTimeStamp": true,
          "required": true,
          "batchGroup": "group1",
          "layoutId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "positionX": 100,
          "positionY": 200,
          "width": 200,
          "height": 50,
          "page": 1,
          "id": "sig1"
        }
      },
      "SignatureFormat": {
        "enum": [
          "Pades",
          "Cades"
        ],
        "type": "string",
        "description": "The signature format for an envelope or template."
      },
      "SignatureLayout": {
        "required": [
          "fields",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The signature layout identifier.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The unique name of the signature layout."
          },
          "fields": {
            "$ref": "#/components/schemas/SignatureLayoutFields"
          },
          "image": {
            "$ref": "#/components/schemas/SignatureLayoutImage"
          }
        },
        "additionalProperties": false,
        "description": "A signature layout of an organization."
      },
      "SignatureLayoutDateTimeField": {
        "required": [
          "localTimezone",
          "visible"
        ],
        "type": "object",
        "properties": {
          "visible": {
            "type": "boolean",
            "description": "Whether the row is shown."
          },
          "format": {
            "type": "string",
            "description": "The date and time format: a `code` returned by GET /api/v1/datetime-formats.",
            "nullable": true
          },
          "localTimezone": {
            "type": "boolean",
            "description": "Whether the date and time are shown in the signer's local timezone. When true, `timezone` is null."
          },
          "timezone": {
            "type": "string",
            "description": "The IANA timezone used when `localTimezone` is false: a `code` returned by GET /api/v1/timezones.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The date and time row of the signature appearance."
      },
      "SignatureLayoutDateTimeFieldRequest": {
        "required": [
          "visible"
        ],
        "type": "object",
        "properties": {
          "visible": {
            "type": "boolean",
            "description": "Whether the row is shown."
          },
          "format": {
            "type": "string",
            "description": "The date and time format: exactly one of the `code` values returned by GET /api/v1/datetime-formats. Required when the row is visible.",
            "nullable": true
          },
          "localTimezone": {
            "type": "boolean",
            "description": "Whether the date and time are shown in the signer's local timezone. Required when the row is visible. When true, `timezone` must be omitted.",
            "nullable": true
          },
          "timezone": {
            "type": "string",
            "description": "The IANA timezone: exactly one of the `code` values returned by GET /api/v1/timezones. Required when `localTimezone` is false.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The date and time row of the signature appearance."
      },
      "SignatureLayoutField": {
        "required": [
          "visible"
        ],
        "type": "object",
        "properties": {
          "visible": {
            "type": "boolean",
            "description": "Whether the row is shown."
          }
        },
        "additionalProperties": false,
        "description": "A row of the signature appearance."
      },
      "SignatureLayoutFields": {
        "required": [
          "customText",
          "dateTime",
          "ipAddress",
          "reason",
          "signerEmail",
          "signerName"
        ],
        "type": "object",
        "properties": {
          "signerName": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "signerEmail": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "ipAddress": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "reason": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "dateTime": {
            "$ref": "#/components/schemas/SignatureLayoutDateTimeField"
          },
          "customText": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          }
        },
        "additionalProperties": false,
        "description": "The configuration of the fields shown in the signature appearance."
      },
      "SignatureLayoutFieldsRequest": {
        "required": [
          "customText",
          "dateTime",
          "ipAddress",
          "reason",
          "signerEmail",
          "signerName"
        ],
        "type": "object",
        "properties": {
          "signerName": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "signerEmail": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "ipAddress": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "reason": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          },
          "dateTime": {
            "$ref": "#/components/schemas/SignatureLayoutDateTimeFieldRequest"
          },
          "customText": {
            "$ref": "#/components/schemas/SignatureLayoutField"
          }
        },
        "additionalProperties": false,
        "description": "The configuration of the fields shown in the signature appearance."
      },
      "SignatureLayoutImage": {
        "required": [
          "dataBase64",
          "mimeType",
          "position"
        ],
        "type": "object",
        "properties": {
          "mimeType": {
            "type": "string",
            "description": "The MIME type: image/png, image/jpeg, image/gif or image/webp."
          },
          "dataBase64": {
            "type": "string",
            "description": "The base64 encoded image, up to 716800 characters (about 512 KB)."
          },
          "position": {
            "$ref": "#/components/schemas/SignatureLayoutImagePosition"
          }
        },
        "additionalProperties": false,
        "description": "The image of the signature appearance."
      },
      "SignatureLayoutImagePosition": {
        "enum": [
          "Background",
          "Above",
          "Below",
          "Left",
          "Right"
        ],
        "type": "string",
        "description": "The position of the image relative to the signature text."
      },
      "SignatureLayoutListResponse": {
        "required": [
          "layouts"
        ],
        "type": "object",
        "properties": {
          "layouts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SignatureLayoutSummary"
            },
            "description": "The signature layouts."
          }
        },
        "additionalProperties": false,
        "description": "List of the signature layouts of an organization."
      },
      "SignatureLayoutRequest": {
        "required": [
          "fields",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name: 1-50 letters, digits or hyphens, not starting or ending with a hyphen. Unique within the organization. \"default\" is reserved."
          },
          "fields": {
            "$ref": "#/components/schemas/SignatureLayoutFieldsRequest"
          },
          "image": {
            "$ref": "#/components/schemas/SignatureLayoutImage"
          }
        },
        "additionalProperties": false,
        "description": "The body used to create or replace a signature layout."
      },
      "SignatureLayoutSummary": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The signature layout identifier.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          },
          "name": {
            "type": "string",
            "description": "The name of the signature layout.",
            "example": "Default layout"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a signature layout."
      },
      "SignatureSettings": {
        "required": [
          "auditTrailMode",
          "defaultSignatureType",
          "timestamp"
        ],
        "type": "object",
        "properties": {
          "defaultSignatureType": {
            "$ref": "#/components/schemas/DefaultSignatureType"
          },
          "auditTrailMode": {
            "$ref": "#/components/schemas/AuditTrailMode"
          },
          "timestamp": {
            "$ref": "#/components/schemas/SignatureSettingsTimestamp"
          },
          "disposableCertificate": {
            "$ref": "#/components/schemas/SignatureSettingsDisposableCertificate"
          },
          "defaultSignatureLayoutId": {
            "type": "string",
            "description": "The identifier of the organization's default signature layout, readable with GET /api/v1/organizations/{organizationId}/settings/signature/layouts/{layoutId}. Read-only. Null until the organization's signature layouts have been read for the first time.",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The organization's signature settings."
      },
      "SignatureSettingsDisposableCertificate": {
        "required": [
          "sendDisposableDisclaimerDocumentNotifications",
          "showDisclaimerBeforeCertificateRequest"
        ],
        "type": "object",
        "properties": {
          "showDisclaimerBeforeCertificateRequest": {
            "type": "boolean",
            "description": "Whether the disclaimer is shown before requesting the certificate."
          },
          "sendDisposableDisclaimerDocumentNotifications": {
            "type": "boolean",
            "description": "Whether disclaimer document notifications are sent."
          },
          "lraId": {
            "type": "string",
            "description": "The LRA identifier.",
            "nullable": true
          },
          "user": {
            "type": "string",
            "description": "The user identifier.",
            "nullable": true
          },
          "disposableType": {
            "$ref": "#/components/schemas/DisposableCertificateType"
          }
        },
        "additionalProperties": false,
        "description": "The organization's disposable certificate configuration, excluding the password."
      },
      "SignatureSettingsTimestamp": {
        "required": [
          "hashAlgorithm"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The timestamp server URL.",
            "nullable": true
          },
          "username": {
            "type": "string",
            "description": "The timestamp server username.",
            "nullable": true
          },
          "hashAlgorithm": {
            "$ref": "#/components/schemas/TimestampHashAlgorithm"
          }
        },
        "additionalProperties": false,
        "description": "The organization's timestamp server configuration, excluding the password."
      },
      "SignatureType": {
        "enum": [
          "ClickToSignSignature",
          "DrawToSignSignature",
          "TypeToSignSignature",
          "LocalCertificateSignature",
          "DisposableCertificateSignature",
          "BiometricSignature",
          "RemoteCertificateSignature",
          "OneTimePasswordSignature",
          "PluginSignature",
          "AutomaticSignature"
        ],
        "type": "string",
        "description": "The available signature types."
      },
      "SigningPlugin": {
        "type": "object",
        "properties": {
          "pluginId": {
            "type": "string",
            "description": "The plugin ID.",
            "nullable": true
          },
          "settings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SigningPluginSetting"
            },
            "description": "The plugin settings.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A signing plugin."
      },
      "SigningPluginSetting": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The setting key.",
            "nullable": true
          },
          "value": {
            "type": "string",
            "description": "The setting value.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A signing plugin setting."
      },
      "SigningPlugins": {
        "type": "object",
        "properties": {
          "plugins": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SigningPlugin"
            },
            "description": "The list of signing plugins.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Signing plugins configuration."
      },
      "StageConfigurationRequest": {
        "required": [
          "name",
          "requiredRecipientCompletions",
          "type"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The stage name."
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "The stage configuration applied by a policy action."
      },
      "StageConfigurationResponse": {
        "required": [
          "name",
          "requiredRecipientCompletions",
          "type"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The stage name."
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          }
        },
        "additionalProperties": false,
        "description": "The stage configuration applied by a policy action."
      },
      "StageMode": {
        "enum": [
          "Standard",
          "Bulk"
        ],
        "type": "string",
        "description": "The mode of a stage, indicating whether it is a standard or bulk signing stage."
      },
      "StageType": {
        "enum": [
          "Signer",
          "CarbonCopy",
          "Viewer",
          "Automatic",
          "Approver"
        ],
        "type": "string",
        "description": "The type of a stage, derived from recipient types."
      },
      "StaticPolicyRecipientSourceRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyRecipientSourceRequest"
          },
          {
            "type": "object",
            "properties": {
              "recipients": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PolicyRecipientRequest"
                },
                "description": "The fixed list of recipients. Required, and used only when Modules.DocumentClasses.Core.Models.StaticPolicyRecipientSourceRequest.Type is `Static`.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Static"
            ],
            "type": "string",
            "default": "Static"
          }
        },
        "description": "Recipients are a fixed list."
      },
      "StaticPolicyRecipientSourceResponse": {
        "required": [
          "recipients",
          "type"
        ],
        "type": "object",
        "properties": {
          "recipients": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyRecipientResponse"
            },
            "description": "The fixed list of recipients."
          },
          "type": {
            "enum": [
              "Static"
            ],
            "type": "string",
            "default": "Static"
          }
        },
        "additionalProperties": false,
        "description": "A policy action's recipient source resolved from a fixed list of recipients."
      },
      "StringDocumentClassMetadataResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentClassMetadataResponse"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "A document class metadata field carrying a text value.",
        "example": {
          "type": "StringType",
          "id": "01097059-216b-4ec9-af09-08f424ec7185",
          "name": "SignerName",
          "required": true,
          "sortOrder": 1
        }
      },
      "StringDocumentMetadataItem": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/DocumentMetadataItem"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "An organization-level document metadata field of type `MetadataValueType.StringType`.",
        "example": {
          "type": "StringType",
          "id": "f054f685-3468-4cc1-a44f-b8c9daf4a57a",
          "name": "ContractNumber"
        }
      },
      "StringFileMetadataValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/FileMetadataValueResponse"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The text value, or null if not set.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "A text metadata value of a file.",
        "example": {
          "value": "New contract",
          "type": "StringType",
          "id": "febedd76-d043-42c2-b1cf-57467fb8c38c",
          "name": "Title"
        }
      },
      "StringInputConfig": {
        "required": [
          "maxLength",
          "multiline",
          "password",
          "textInputType",
          "value"
        ],
        "type": "object",
        "properties": {
          "textInputType": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          },
          "value": {
            "type": "string",
            "description": "The text value."
          },
          "password": {
            "type": "boolean",
            "description": "Whether the field is a password field."
          },
          "multiline": {
            "type": "boolean",
            "description": "Whether the field allows multiline input."
          },
          "maxLength": {
            "type": "integer",
            "description": "The maximum length of the text.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Configuration for a string text input.",
        "example": {
          "textInputType": "StringType",
          "value": "Default text",
          "password": false,
          "multiline": false,
          "maxLength": 100
        }
      },
      "StringMetadataValueRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/MetadataValueRequest"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The string value.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "A metadata value carrying a text payload."
      },
      "StringOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "type": "string",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "StringOptionalNullable": {
        "required": [
          "isSet"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "StringPolicyConditionMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataRequest"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The comparison text value.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "A policy condition's comparison value for a string-type metadata field."
      },
      "StringPolicyConditionValueResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/PolicyConditionMetadataResponse"
          },
          {
            "required": [
              "value"
            ],
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The comparison text value.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "A policy condition's comparison value for a string-type metadata field."
      },
      "SymbolPosition": {
        "enum": [
          "Start",
          "StartWithBlank",
          "End",
          "EndWithBlank"
        ],
        "type": "string",
        "description": "The position of the symbol relative to a number value."
      },
      "TemplateAutomaticRecipientResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/TemplateRecipientResponse"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "The friendly name of the eSealing signature profile used for automatic signing.",
                "nullable": true
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Detailed representation of an Automatic recipient.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "id": "00000000-0000-0000-0000-000000000100",
          "languageCode": "en-US"
        }
      },
      "TemplateFileDetailResponse": {
        "type": "object",
        "properties": {
          "documentClass": {
            "$ref": "#/components/schemas/TemplateFileDocumentClassResponse"
          },
          "restrictedVisibilityRecipientIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The IDs of recipients with restricted visibility to this file, or null if not set.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Response containing details of a template file."
      },
      "TemplateFileDocumentClassResponse": {
        "required": [
          "id",
          "metadata"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The assigned document class ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The document class name, or null if none is assigned.",
            "nullable": true
          },
          "metadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/NumberFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/DateFileMetadataValueResponse"
                },
                {
                  "$ref": "#/components/schemas/ListOptionFileMetadataValueResponse"
                }
              ],
              "description": "A metadata field value of a file. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
            },
            "description": "The metadata field values for this file."
          }
        },
        "additionalProperties": false,
        "description": "Response containing the document class assigned to a template file."
      },
      "TemplateFileListResponse": {
        "required": [
          "files"
        ],
        "type": "object",
        "properties": {
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TemplateFileResponse"
            },
            "description": "The list of files."
          }
        },
        "additionalProperties": false,
        "description": "List of files."
      },
      "TemplateFileResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The file ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The file name."
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the file in the sequence.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Representation of a file."
      },
      "TemplateFileSummaryResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The file ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The file name."
          },
          "sortOrder": {
            "type": "integer",
            "description": "The file sort order.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Summary of a template file."
      },
      "TemplateListResponse": {
        "required": [
          "pagination",
          "templates"
        ],
        "type": "object",
        "properties": {
          "templates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TemplateSummary"
            },
            "description": "The list of templates."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of templates."
      },
      "TemplateRecipientResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The recipient ID.",
            "format": "uuid"
          },
          "languageCode": {
            "type": "string",
            "description": "The language code for the recipient's notifications.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a recipient. Base for polymorphic response."
      },
      "TemplateReminderResponse": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled."
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32"
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32"
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "TemplateResponse": {
        "required": [
          "createdAt",
          "fileRestrictedVisibility",
          "files",
          "id",
          "qualifiedTimeStamp",
          "signatureFormat",
          "stages",
          "updatedAt"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The template ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The template name.",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "description": "When the template was created.",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the template was last updated.",
            "format": "date-time"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteTemplateExpirationResponse"
              },
              {
                "$ref": "#/components/schemas/RelativeTemplateExpirationResponse"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/TemplateReminderResponse"
          },
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TemplateStageSummaryResponse"
            },
            "description": "The stages of the template."
          },
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TemplateFileSummaryResponse"
            },
            "description": "The files of the template."
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the template must use a qualified timestamp server.",
            "example": true
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the template, or null.",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language, or null when no custom agreements are configured.",
            "nullable": true
          },
          "fileRestrictedVisibility": {
            "type": "boolean",
            "description": "Whether file visibility is restricted per recipient.",
            "example": false
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the envelope.",
            "nullable": true,
            "example": "https://example.com/envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a template."
      },
      "TemplateStageAutomaticRecipientSummary": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/TemplateStageRecipientSummary"
          },
          {
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "The friendly name of the eSealing signature profile used for automatic signing.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Stage summary for an Automatic recipient."
      },
      "TemplateStageListResponse": {
        "required": [
          "stages"
        ],
        "type": "object",
        "properties": {
          "stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TemplateStageSummary"
            },
            "description": "The list of stages."
          }
        },
        "additionalProperties": false,
        "description": "List of stages."
      },
      "TemplateStageRecipientSummary": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The recipient ID.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a stage recipient. Base for polymorphic response."
      },
      "TemplateStageResponse": {
        "required": [
          "id",
          "name",
          "recipients",
          "requiredRecipientCompletions",
          "sortOrder",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The stage name."
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32"
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          },
          "recipients": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/TemplateStageStandardRecipientSummary"
                },
                {
                  "$ref": "#/components/schemas/TemplateStageAutomaticRecipientSummary"
                }
              ],
              "description": "Summary representation of a stage recipient. Base for polymorphic response."
            },
            "description": "The recipients of the stage."
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a stage."
      },
      "TemplateStageSortOrder": {
        "required": [
          "id",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The new position of the stage.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Sort order entry for a stage."
      },
      "TemplateStageStandardRecipientSummary": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/TemplateStageRecipientSummary"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Stage summary for a Recipient recipient."
      },
      "TemplateStageSummary": {
        "required": [
          "id",
          "name",
          "requiredRecipientCompletions",
          "sortOrder",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The stage name."
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32"
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a stage."
      },
      "TemplateStageSummaryResponse": {
        "required": [
          "id",
          "name",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The stage ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The stage name."
          },
          "sortOrder": {
            "type": "integer",
            "description": "The position of the stage in the sequence.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Stage summary within a template response."
      },
      "TemplateStandardRecipientResponse": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/TemplateRecipientResponse"
          },
          {
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/RecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/RecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Detailed representation of a Recipient recipient.",
        "example": {
          "type": "Standard",
          "givenName": "Mario",
          "surname": "Rossi",
          "email": "mario.rossi@example.com",
          "phoneNumber": "+39123456789",
          "notificationChannels": [
            "Email"
          ],
          "personalMessage": "Please review and sign the attached document.",
          "id": "00000000-0000-0000-0000-000000000100",
          "languageCode": "en-US"
        }
      },
      "TemplateSummary": {
        "required": [
          "createdAt",
          "id",
          "name",
          "updatedAt"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The template ID.",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "description": "The template name."
          },
          "createdAt": {
            "type": "string",
            "description": "When the template was created.",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "When the template was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a template."
      },
      "TextAlign": {
        "enum": [
          "Left",
          "Center",
          "Right"
        ],
        "type": "string",
        "description": "Text alignment options."
      },
      "TextAnnotationValueFormat": {
        "required": [
          "annotationType"
        ],
        "type": "object",
        "properties": {
          "annotationType": {
            "enum": [
              "Text"
            ],
            "type": "string",
            "default": "Text"
          },
          "value": {
            "type": "string",
            "description": "The default value for the text annotation.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Free text annotation value format."
      },
      "TextInputField": {
        "required": [
          "fieldType"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseField"
          },
          {
            "required": [
              "textInputConfig"
            ],
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "description": "The page number where the field is placed.",
                "format": "int32"
              },
              "positionX": {
                "type": "number",
                "description": "The horizontal position of the field on the page.",
                "format": "double"
              },
              "positionY": {
                "type": "number",
                "description": "The vertical position of the field on the page.",
                "format": "double"
              },
              "width": {
                "type": "number",
                "description": "The width of the field.",
                "format": "double"
              },
              "height": {
                "type": "number",
                "description": "The height of the field.",
                "format": "double"
              },
              "font": {
                "$ref": "#/components/schemas/FontStyle"
              },
              "textInputConfig": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/StringInputConfig"
                  },
                  {
                    "$ref": "#/components/schemas/DateInputConfig"
                  },
                  {
                    "$ref": "#/components/schemas/NumberInputConfig"
                  },
                  {
                    "$ref": "#/components/schemas/PhoneNumberInputConfig"
                  },
                  {
                    "$ref": "#/components/schemas/TimeInputConfig"
                  },
                  {
                    "enum": [
                      null
                    ],
                    "nullable": true
                  }
                ],
                "description": "The text input configuration."
              },
              "readOnly": {
                "type": "boolean",
                "description": "Whether the field is read-only."
              },
              "required": {
                "type": "boolean",
                "description": "Whether the field is required."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "fieldType": {
            "enum": [
              "TextInput"
            ],
            "type": "string",
            "default": "TextInput"
          }
        },
        "description": "A text input field with font and input configuration.",
        "example": {
          "fieldType": "TextInput",
          "font": {
            "size": 12,
            "name": "Arial",
            "color": "#000000",
            "align": "Left",
            "italic": false,
            "bold": false
          },
          "textInputConfig": {
            "textInputType": "StringType",
            "value": "Default text",
            "password": false,
            "multiline": false,
            "maxLength": 100
          },
          "readOnly": false,
          "required": false,
          "positionX": 50,
          "positionY": 100,
          "width": 150,
          "height": 30,
          "page": 1,
          "id": "txt1"
        }
      },
      "TextInputType": {
        "enum": [
          "StringType",
          "DateType",
          "NumberType",
          "PhoneNumberType",
          "TimeType"
        ],
        "type": "string",
        "description": "The type of text input."
      },
      "ThousandsSeparator": {
        "enum": [
          "Comma",
          "Point",
          "Apostrophe",
          "Blank",
          "None"
        ],
        "type": "string",
        "description": "The thousands separator used by a number text input."
      },
      "TimeFormat": {
        "enum": [
          "HH:mm"
        ],
        "type": "string",
        "description": "Available time display formats for a time text input."
      },
      "TimeInputConfig": {
        "required": [
          "format",
          "textInputType"
        ],
        "type": "object",
        "properties": {
          "textInputType": {
            "enum": [
              "TimeType"
            ],
            "type": "string",
            "default": "TimeType"
          },
          "value": {
            "type": "string",
            "description": "The time value.",
            "format": "time",
            "nullable": true
          },
          "format": {
            "$ref": "#/components/schemas/TimeFormat"
          },
          "minValue": {
            "type": "string",
            "description": "The minimum allowed time.",
            "format": "time",
            "nullable": true
          },
          "maxValue": {
            "type": "string",
            "description": "The maximum allowed time.",
            "format": "time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Configuration for a time text input.",
        "example": {
          "textInputType": "TimeType",
          "value": "14:30:00",
          "format": "HH:mm",
          "minValue": "08:00:00",
          "maxValue": "18:00:00"
        }
      },
      "TimeZoneListResponse": {
        "required": [
          "timeZones"
        ],
        "type": "object",
        "properties": {
          "timeZones": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TimeZoneResponse"
            },
            "description": "The list of time zones."
          }
        },
        "additionalProperties": false,
        "description": "List of available time zones."
      },
      "TimeZoneResponse": {
        "required": [
          "code",
          "name"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The IANA time zone identifier.",
            "example": "Europe/Berlin"
          },
          "name": {
            "type": "string",
            "description": "The display name of the time zone.",
            "example": "(UTC+01:00) Berlin"
          }
        },
        "additionalProperties": false,
        "description": "A time zone available for selection."
      },
      "TimestampHashAlgorithm": {
        "enum": [
          "SHA-1",
          "SHA-256",
          "SHA-512"
        ],
        "type": "string",
        "description": "The hash algorithms supported by a timestamp server configuration."
      },
      "TimestampHashAlgorithmOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/TimestampHashAlgorithm"
          }
        },
        "additionalProperties": false
      },
      "TypeToSignSignature": {
        "required": [
          "signatureType"
        ],
        "type": "object",
        "properties": {
          "signatureType": {
            "enum": [
              "TypeToSignSignature"
            ],
            "type": "string",
            "default": "TypeToSignSignature"
          }
        },
        "additionalProperties": false,
        "description": "Type to sign signature configuration.",
        "example": {
          "signatureType": "TypeToSignSignature"
        }
      },
      "UpdateAccessCode": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The access code.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Access code configuration for update."
      },
      "UpdateApplicationRoleRequest": {
        "required": [
          "name",
          "permissions"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The application role name.",
            "example": "Contract Reviewer"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "description": "The entity/action permission pairs granted by the application role."
          },
          "description": {
            "type": "string",
            "description": "The application role description.",
            "nullable": true,
            "example": "Can read envelopes"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating an application role."
      },
      "UpdateAuthenticationOneTimePassword": {
        "required": [
          "channel"
        ],
        "type": "object",
        "properties": {
          "channel": {
            "$ref": "#/components/schemas/OneTimePasswordAuthenticationChannel"
          }
        },
        "additionalProperties": false,
        "description": "OTP authentication configuration for update."
      },
      "UpdateBulkEnvelopeFileDetailRequest": {
        "required": [
          "documentClass"
        ],
        "type": "object",
        "properties": {
          "documentClass": {
            "$ref": "#/components/schemas/UpdateBulkEnvelopeFileDocumentClassRequest"
          },
          "restrictedVisibilityRecipientIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The IDs of recipients with restricted visibility to this file. Null means no change.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating the details of a bulk envelope file."
      },
      "UpdateBulkEnvelopeFileDocumentClassRequest": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The document class identifier.",
            "format": "uuid"
          },
          "metadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/NumberMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/DateMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/ListOptionMetadataValueRequest"
                }
              ],
              "description": "A metadata field value. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
            },
            "description": "The metadata values to assign.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating the document class of a bulk envelope file."
      },
      "UpdateBulkEnvelopeFileTasksRequest": {
        "required": [
          "tasks"
        ],
        "type": "object",
        "properties": {
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkEnvelopeFieldTaskRequest"
            },
            "description": "The complete list of tasks for the file."
          }
        },
        "additionalProperties": false,
        "description": "Request body for replacing the field tasks of a bulk-envelope file."
      },
      "UpdateBulkEnvelopeReminderRequest": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "UpdateBulkEnvelopeRequest": {
        "required": [
          "expiration",
          "name",
          "reminder"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The bulk envelope name.",
            "example": "Updated bulk contract name"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteUpdateBulkEnvelopeExpirationRequest"
              },
              {
                "$ref": "#/components/schemas/RelativeUpdateBulkEnvelopeExpirationRequest"
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/UpdateBulkEnvelopeReminderRequest"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the bulk envelope must use a qualified timestamp server. Optional. When omitted, the value `false` is applied at the downstream Nova boundary.",
            "nullable": true,
            "example": true
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the bulk envelope. Null or omitted overwrites the persisted value to null (full PUT semantics).",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language. Null means no change (keep existing); empty list clears all agreements.",
            "nullable": true
          },
          "fileRestrictedVisibility": {
            "type": "boolean",
            "description": "Whether file visibility is restricted per recipient. Null means no change.",
            "nullable": true,
            "example": false
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the bulk envelope. Null or omitted overwrites the persisted value to null (full PUT semantics).",
            "nullable": true,
            "example": "https://example.com/bulk-envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a bulk envelope."
      },
      "UpdateBulkEnvelopeStageAutomaticRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateBulkEnvelopeStageRecipientRequest"
          },
          {
            "required": [
              "signatureProfile"
            ],
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "Signature profile name for the automatic recipient.",
                "nullable": true,
                "example": "default-eseal-profile"
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Request to update an automatic recipient on a bulk envelope stage.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "signatureReason": "I agree to the terms.",
          "languageCode": "en"
        }
      },
      "UpdateBulkEnvelopeStageRecipientRequest": {
        "type": "object",
        "properties": {
          "languageCode": {
            "type": "string",
            "description": "BCP 47 language code for recipient notifications.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "Base record for update bulk envelope stage recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
      },
      "UpdateBulkEnvelopeStageRequest": {
        "required": [
          "name",
          "requiredRecipientCompletions",
          "type"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Updated Stage Name"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a bulk envelope stage."
      },
      "UpdateBulkEnvelopeStageStandardRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateBulkEnvelopeStageRecipientRequest"
          },
          {
            "required": [
              "email",
              "givenName",
              "notificationChannels",
              "phoneNumber",
              "surname"
            ],
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true,
                "example": "Mario"
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true,
                "example": "Rossi"
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true,
                "example": "mario.rossi@example.com"
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true,
                "example": "+39123456789"
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/UpdateRecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/UpdateRecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true,
                "example": "Please review and sign the attached contract."
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Request body for updating a Standard recipient on a bulk envelope stage."
      },
      "UpdateBusinessRoleRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The business role name.",
            "example": "Approver"
          },
          "description": {
            "type": "string",
            "description": "The optional business role description. Omitted or null clears the description.",
            "nullable": true,
            "example": "Approves envelopes before completion."
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a business role."
      },
      "UpdateDateDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "DateType"
            ],
            "type": "string",
            "default": "DateType"
          }
        },
        "description": "Request body for updating a document metadata field of type `MetadataValueType.DateType`.",
        "example": {
          "type": "DateType",
          "name": "SignatureDate"
        }
      },
      "UpdateDisposableCertificate": {
        "type": "object",
        "properties": {
          "document": {
            "$ref": "#/components/schemas/UpdateDisposableCertificateDocument"
          },
          "identification": {
            "$ref": "#/components/schemas/UpdateDisposableCertificateIdentification"
          },
          "verificationPhoneNumber": {
            "type": "string",
            "description": "The phone number for verification.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Disposable certificate configuration for update."
      },
      "UpdateDisposableCertificateDocument": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The document type.",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "The document number.",
            "nullable": true
          },
          "serialNumber": {
            "type": "string",
            "description": "The document serial number.",
            "nullable": true
          },
          "issuingCountry": {
            "type": "string",
            "description": "The issuing country.",
            "nullable": true
          },
          "issuedBy": {
            "type": "string",
            "description": "The issuing authority.",
            "nullable": true
          },
          "issuedOn": {
            "type": "string",
            "description": "When the document was issued.",
            "format": "date-time",
            "nullable": true
          },
          "expiresAt": {
            "type": "string",
            "description": "When the document expires.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Identity document for disposable certificate during update."
      },
      "UpdateDisposableCertificateIdentification": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/DisposableCertificateIdentificationType"
          },
          "issuingCountry": {
            "type": "string",
            "description": "The issuing country.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Identification method for disposable certificate during update."
      },
      "UpdateDocumentClassRequest": {
        "required": [
          "description",
          "metadata",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The document class name.",
            "example": "Contract"
          },
          "description": {
            "type": "string",
            "description": "A description of the document class.",
            "example": "Documents related to contracts"
          },
          "metadata": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DocumentClassMetadataReferenceRequest"
            },
            "description": "The metadata field references for this document class."
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a document class."
      },
      "UpdateDocumentMetadataRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a document metadata field. Discriminated by the `type` property."
      },
      "UpdateEnvelopeAutomaticRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateEnvelopeRecipientRequest"
          },
          {
            "required": [
              "signatureProfile"
            ],
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "Signature profile name for the automatic recipient.",
                "nullable": true,
                "example": "default-eseal-profile"
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Request to update an automatic recipient in an envelope stage.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "signatureReason": "I agree to the terms.",
          "languageCode": "en"
        }
      },
      "UpdateEnvelopeFileDetailRequest": {
        "required": [
          "documentClass"
        ],
        "type": "object",
        "properties": {
          "documentClass": {
            "$ref": "#/components/schemas/UpdateEnvelopeFileDocumentClassRequest"
          },
          "restrictedVisibilityRecipientIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The IDs of recipients with restricted visibility to this file. Null means no change.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating the details of an envelope file."
      },
      "UpdateEnvelopeFileDocumentClassRequest": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The document class identifier.",
            "format": "uuid"
          },
          "metadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/NumberMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/DateMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/ListOptionMetadataValueRequest"
                }
              ],
              "description": "A metadata field value. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
            },
            "description": "The metadata values to assign.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating the document class of an envelope file."
      },
      "UpdateEnvelopeFileTasksRequest": {
        "required": [
          "tasks"
        ],
        "type": "object",
        "properties": {
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FieldTaskRequest"
            },
            "description": "The complete list of tasks for the file."
          }
        },
        "additionalProperties": false,
        "description": "Request body for replacing file tasks."
      },
      "UpdateEnvelopeRecipientRequest": {
        "type": "object",
        "properties": {
          "languageCode": {
            "type": "string",
            "description": "BCP 47 language code for recipient notifications.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "Base record for update envelope recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
      },
      "UpdateEnvelopeReminderRequest": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "UpdateEnvelopeRequest": {
        "required": [
          "expiration",
          "name",
          "reminder"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The envelope name.",
            "example": "Updated contract name"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteUpdateEnvelopeExpirationRequest"
              },
              {
                "$ref": "#/components/schemas/RelativeUpdateEnvelopeExpirationRequest"
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/UpdateEnvelopeReminderRequest"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the envelope must use a qualified timestamp server. Optional. When omitted, the value `false` is applied at the downstream Nova boundary.",
            "nullable": true,
            "example": true
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the envelope. Null or omitted overwrites the persisted value to null (full PUT semantics).",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language. Null means no change (keep existing); empty list clears all agreements.",
            "nullable": true
          },
          "fileRestrictedVisibility": {
            "type": "boolean",
            "description": "Whether file visibility is restricted per recipient. Null means no change.",
            "nullable": true,
            "example": false
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the envelope. Null or omitted overwrites the persisted value to null (full PUT semantics).",
            "nullable": true,
            "example": "https://example.com/envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating an envelope."
      },
      "UpdateEnvelopeStageRequest": {
        "required": [
          "name",
          "requiredRecipientCompletions",
          "type"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Updated Stage Name"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a stage."
      },
      "UpdateEnvelopeStandardRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateEnvelopeRecipientRequest"
          },
          {
            "required": [
              "email",
              "givenName",
              "notificationChannels",
              "phoneNumber",
              "surname"
            ],
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true,
                "example": "Mario"
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true,
                "example": "Rossi"
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true,
                "example": "mario.rossi@example.com"
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true,
                "example": "+39123456789"
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/UpdateRecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/UpdateRecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true,
                "example": "Please review and sign the attached contract."
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Request body for updating a Standard recipient."
      },
      "UpdateEnvelopeWebhookRequest": {
        "required": [
          "event",
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls (max 2048 characters).",
            "example": "https://example.com/hooks/envelope-new"
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationRequest"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating an envelope webhook."
      },
      "UpdateGeneralSettingsRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The organization's name.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Request to update the general settings of an organization."
      },
      "UpdateLanguageSettingsRequest": {
        "required": [
          "languages"
        ],
        "type": "object",
        "properties": {
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The language codes to enable for the organization. Replaces the entire list."
          }
        },
        "additionalProperties": false,
        "description": "Request to replace the enabled languages of an organization."
      },
      "UpdateListOptionDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "properties": {
              "options": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DocumentMetadataOptionRequest"
                },
                "description": "The predefined selectable options. Must be non-empty. Fully replaces the existing set.",
                "nullable": true
              },
              "parentId": {
                "type": "string",
                "description": "The ID of an existing metadata field of type ListOptionType to set as this field's parent, or omit for no parent. Must not be this field itself or one of its children.",
                "format": "uuid",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "ListOptionType"
            ],
            "type": "string",
            "default": "ListOptionType"
          }
        },
        "description": "Request body for updating a document metadata field of type `MetadataValueType.ListOptionType`.",
        "example": {
          "options": [
            {
              "value": "Invoice",
              "parentId": "8d2b352e-e36a-45c1-904c-61c599d9bf6e"
            },
            {
              "value": "NDA"
            }
          ],
          "parentId": "bb1fb957-ed45-4ba6-b10f-31594e765cb5",
          "type": "ListOptionType",
          "name": "ContractType"
        }
      },
      "UpdateNumberDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "NumberType"
            ],
            "type": "string",
            "default": "NumberType"
          }
        },
        "description": "Request body for updating a document metadata field of type `MetadataValueType.NumberType`.",
        "example": {
          "type": "NumberType",
          "name": "TotalAmount"
        }
      },
      "UpdateOAuthAuthentication": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "providerName": {
            "type": "string",
            "description": "The OAuth provider name.",
            "nullable": true
          },
          "id": {
            "type": "string",
            "description": "The identifier of the OAuth provider.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "OAuth authentication configuration for update."
      },
      "UpdateOneTimePasswordRequest": {
        "required": [
          "enabled"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether one time password authentication is enabled."
          }
        },
        "additionalProperties": false,
        "description": "One-time password authentication configuration to enable."
      },
      "UpdateOneTimePasswordRequestOptionalNullable": {
        "required": [
          "isSet"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateOneTimePasswordRequest"
          }
        },
        "additionalProperties": false
      },
      "UpdateOrganizationWebhookRequest": {
        "required": [
          "event",
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL receiving the webhook calls (max 2048 characters).",
            "example": "https://example.com/hooks/organization-new"
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "authentication": {
            "$ref": "#/components/schemas/WebhookAuthenticationRequest"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating an organization webhook."
      },
      "UpdateOtpSignature": {
        "type": "object",
        "properties": {
          "channel": {
            "$ref": "#/components/schemas/OtpDeliveryChannel"
          }
        },
        "additionalProperties": false,
        "description": "OTP signature configuration for update."
      },
      "UpdatePolicyRequest": {
        "required": [
          "actions",
          "conditions",
          "isActive",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The policy name.",
            "example": "Standard signing policy"
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether the policy is active.",
            "example": true
          },
          "description": {
            "type": "string",
            "description": "The policy description.",
            "nullable": true,
            "example": "Policy applied to all standard signing envelopes"
          },
          "documentClassId": {
            "type": "string",
            "description": "The document class this policy applies to, when set.",
            "format": "uuid",
            "nullable": true
          },
          "conditions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyConditionRequest"
            },
            "description": "The policy's conditions. `sortOrder` must start at 1, be unique, and contiguous within the list."
          },
          "actions": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/AddEnvelopeStageConfigurationActionRequest"
                }
              ],
              "description": "A single action within a policy request. Discriminated by the `type` property."
            },
            "description": "The policy's actions. `sortOrder` must start at 1, be unique, and contiguous within the list."
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a policy."
      },
      "UpdateRecipientAuthentication": {
        "type": "object",
        "properties": {
          "accessCode": {
            "$ref": "#/components/schemas/UpdateAccessCode"
          },
          "oneTimePassword": {
            "$ref": "#/components/schemas/UpdateAuthenticationOneTimePassword"
          },
          "oAuthAuthentications": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UpdateOAuthAuthentication"
            },
            "description": "OAuth authentications.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Recipient authentication configuration for update."
      },
      "UpdateRecipientAuthenticationsRequest": {
        "type": "object",
        "properties": {
          "accessCode": {
            "type": "boolean",
            "description": "Whether access code authentication is enabled.\n\n_optional: omission ignores property_"
          },
          "oneTimePassword": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateOneTimePasswordRequest"
              },
              {
                "enum": [
                  null
                ],
                "nullable": true
              }
            ],
            "description": "The one-time password authentication configuration. May be omitted, set to null to disable, or set to a value to enable.\n\n_optional: `null` sets to null, omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Recipient authentication settings values to persist. Unset fields retain their current value."
      },
      "UpdateRecipientAuthenticationsRequestOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateRecipientAuthenticationsRequest"
          }
        },
        "additionalProperties": false
      },
      "UpdateRecipientSettingsRequest": {
        "type": "object",
        "properties": {
          "sendCompletedFileToAllRecipients": {
            "type": "boolean",
            "description": "Whether the completed file is sent to all recipients.\n\n_optional: omission ignores property_"
          },
          "warnIfRecipientsHaveNoFields": {
            "type": "boolean",
            "description": "Whether a warning is shown when some recipients have no fields.\n\n_optional: omission ignores property_"
          },
          "authentications": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateRecipientAuthenticationsRequest"
              }
            ],
            "description": "The organization's recipient authentication settings.\n\n_optional: omission ignores property_"
          },
          "recipientDelegation": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/RecipientDelegation"
              }
            ],
            "description": "The organization's recipient delegation policy.\n\n_optional: omission ignores property_"
          },
          "mandatoryAuthentication": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationNone"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationAny"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationAccessCode"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationOneTimePassword"
              },
              {
                "$ref": "#/components/schemas/MandatoryAuthenticationOAuth"
              }
            ],
            "description": "The organization's mandatory (forced) recipient authentication method.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Request to update the recipient settings of an organization."
      },
      "UpdateRecipientSignatureData": {
        "type": "object",
        "properties": {
          "disposableCertificate": {
            "$ref": "#/components/schemas/UpdateDisposableCertificate"
          },
          "remoteCertificate": {
            "$ref": "#/components/schemas/UpdateRemoteCertificateDto"
          },
          "otpSignature": {
            "$ref": "#/components/schemas/UpdateOtpSignature"
          },
          "signingPlugins": {
            "$ref": "#/components/schemas/UpdateSigningPlugins"
          }
        },
        "additionalProperties": false,
        "description": "Signature configuration for a recipient during update."
      },
      "UpdateRegionalDefaultsSettingsRequest": {
        "required": [
          "dateTimeFormat",
          "language",
          "timeZone"
        ],
        "type": "object",
        "properties": {
          "timeZone": {
            "type": "string",
            "description": "The default IANA time zone identifier.",
            "example": "Europe/Berlin"
          },
          "dateTimeFormat": {
            "$ref": "#/components/schemas/DateTimeFormat"
          },
          "language": {
            "type": "string",
            "description": "The default language code. Must be one of the organization's enabled languages.",
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "Request to replace the regional defaults of an organization."
      },
      "UpdateRemoteCertificateDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "description": "The user ID.",
            "nullable": true
          },
          "deviceId": {
            "type": "string",
            "description": "The device ID.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Remote certificate configuration for update."
      },
      "UpdateSignatureSettingsDisposableCertificate": {
        "type": "object",
        "properties": {
          "lraId": {
            "type": "string",
            "description": "The LRA identifier. May be omitted, set to null/empty to clear, or set to a value.\n\n_optional: `null` sets to null, omission ignores property_",
            "nullable": true
          },
          "user": {
            "type": "string",
            "description": "The user identifier. May be omitted, set to null/empty to clear, or set to a value.\n\n_optional: `null` sets to null, omission ignores property_",
            "nullable": true
          },
          "password": {
            "type": "string",
            "description": "The disposable certificate password. May be omitted, set to null/empty to clear, or set to a value.\n\n_optional: `null` sets to null, omission ignores property_",
            "nullable": true
          },
          "disposableType": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/DisposableCertificateType"
              }
            ],
            "description": "The disposable certificate type.\n\n_optional: omission ignores property_"
          },
          "showDisclaimerBeforeCertificateRequest": {
            "type": "boolean",
            "description": "Whether the disclaimer is shown before requesting the certificate.\n\n_optional: omission ignores property_"
          },
          "sendDisposableDisclaimerDocumentNotifications": {
            "type": "boolean",
            "description": "Whether disclaimer document notifications are sent.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Disposable certificate configuration values to persist, including the optional password. Unset fields retain their current value."
      },
      "UpdateSignatureSettingsDisposableCertificateOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateSignatureSettingsDisposableCertificate"
          }
        },
        "additionalProperties": false
      },
      "UpdateSignatureSettingsRequest": {
        "type": "object",
        "properties": {
          "defaultSignatureType": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/DefaultSignatureType"
              }
            ],
            "description": "The organization's default signature type.\n\n_optional: omission ignores property_"
          },
          "auditTrailMode": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AuditTrailMode"
              }
            ],
            "description": "The organization's audit trail generation mode.\n\n_optional: omission ignores property_"
          },
          "timestamp": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateSignatureSettingsTimestamp"
              }
            ],
            "description": "The organization's timestamp server configuration.\n\n_optional: omission ignores property_"
          },
          "disposableCertificate": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateSignatureSettingsDisposableCertificate"
              }
            ],
            "description": "The organization's disposable certificate configuration.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Request to update the signature settings of an organization."
      },
      "UpdateSignatureSettingsTimestamp": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The timestamp server URL. May be omitted, set to null/empty to clear, or set to a value.\n\n_optional: `null` sets to null, omission ignores property_",
            "nullable": true
          },
          "username": {
            "type": "string",
            "description": "The timestamp server username. May be omitted, set to null/empty to clear, or set to a value.\n\n_optional: `null` sets to null, omission ignores property_",
            "nullable": true
          },
          "password": {
            "type": "string",
            "description": "The timestamp server password. May be omitted, set to null/empty to clear, or set to a value.\n\n_optional: `null` sets to null, omission ignores property_",
            "nullable": true
          },
          "hashAlgorithm": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/TimestampHashAlgorithm"
              }
            ],
            "description": "The hash algorithm used by the timestamp server.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Timestamp server configuration values to persist, including the password. Unset fields retain their current value."
      },
      "UpdateSignatureSettingsTimestampOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateSignatureSettingsTimestamp"
          }
        },
        "additionalProperties": false
      },
      "UpdateSigningPlugin": {
        "type": "object",
        "properties": {
          "pluginId": {
            "type": "string",
            "description": "The plugin ID.",
            "nullable": true
          },
          "settings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UpdateSigningPluginSetting"
            },
            "description": "The plugin settings.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A signing plugin for update."
      },
      "UpdateSigningPluginSetting": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The setting key.",
            "nullable": true
          },
          "value": {
            "type": "string",
            "description": "The setting value.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A signing plugin setting for update."
      },
      "UpdateSigningPlugins": {
        "type": "object",
        "properties": {
          "plugins": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UpdateSigningPlugin"
            },
            "description": "The list of signing plugins.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Signing plugins configuration for update."
      },
      "UpdateStringDocumentMetadataRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateDocumentMetadataRequest"
          },
          {
            "type": "object",
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "StringType"
            ],
            "type": "string",
            "default": "StringType"
          }
        },
        "description": "Request body for updating a document metadata field of type `MetadataValueType.StringType`.",
        "example": {
          "type": "StringType",
          "name": "ContractNumber"
        }
      },
      "UpdateTemplateAutomaticRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateTemplateRecipientRequest"
          },
          {
            "required": [
              "signatureProfile"
            ],
            "type": "object",
            "properties": {
              "signatureProfile": {
                "type": "string",
                "description": "The friendly name of the eSealing signature profile.",
                "nullable": true
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Automatic"
            ],
            "type": "string",
            "default": "Automatic"
          }
        },
        "description": "Request body for updating an Automatic recipient.",
        "example": {
          "type": "Automatic",
          "signatureProfile": "default-eseal-profile",
          "signatureReason": "I agree to the terms.",
          "languageCode": "en"
        }
      },
      "UpdateTemplateFileDetailRequest": {
        "required": [
          "documentClass"
        ],
        "type": "object",
        "properties": {
          "documentClass": {
            "$ref": "#/components/schemas/UpdateTemplateFileDocumentClassRequest"
          },
          "restrictedVisibilityRecipientIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The IDs of recipients with restricted visibility to this file. Null means no change.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating the details of a template file."
      },
      "UpdateTemplateFileDocumentClassRequest": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The document class identifier.",
            "format": "uuid"
          },
          "metadata": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/StringMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/NumberMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/DateMetadataValueRequest"
                },
                {
                  "$ref": "#/components/schemas/ListOptionMetadataValueRequest"
                }
              ],
              "description": "A metadata field value. Discriminated by the `type` property: `\"StringType\"`, `\"NumberType\"`, `\"DateType\"`, `\"ListOptionType\"`."
            },
            "description": "The metadata values to assign.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating the document class of a template file."
      },
      "UpdateTemplateFileTasksRequest": {
        "required": [
          "tasks"
        ],
        "type": "object",
        "properties": {
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FieldTaskRequest"
            },
            "description": "The complete list of tasks for the file."
          }
        },
        "additionalProperties": false,
        "description": "Request body for replacing file tasks."
      },
      "UpdateTemplateRecipientRequest": {
        "type": "object",
        "properties": {
          "languageCode": {
            "type": "string",
            "description": "BCP 47 language code for recipient notifications.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": false,
        "description": "Base record for update template recipient requests. The `type` discriminator accepts `Standard` or `Automatic`."
      },
      "UpdateTemplateReminderRequest": {
        "required": [
          "beforeExpirationInDays",
          "enabled",
          "firstReminderInDays",
          "resendIntervalInDays"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Whether reminders are enabled.",
            "example": true
          },
          "firstReminderInDays": {
            "type": "integer",
            "description": "Days after sending before the first reminder.",
            "format": "int32",
            "example": 5
          },
          "resendIntervalInDays": {
            "type": "integer",
            "description": "Days between subsequent reminders.",
            "format": "int32",
            "example": 3
          },
          "beforeExpirationInDays": {
            "type": "integer",
            "description": "Days before expiration to send the last reminder.",
            "format": "int32",
            "example": 2
          }
        },
        "additionalProperties": false,
        "description": "Reminder configuration."
      },
      "UpdateTemplateRequest": {
        "required": [
          "expiration",
          "name",
          "reminder"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The template name.",
            "example": "Updated NDA template"
          },
          "expiration": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/AbsoluteUpdateTemplateExpirationRequest"
              },
              {
                "$ref": "#/components/schemas/RelativeUpdateTemplateExpirationRequest"
              }
            ],
            "description": "The expiration settings."
          },
          "reminder": {
            "$ref": "#/components/schemas/UpdateTemplateReminderRequest"
          },
          "qualifiedTimeStamp": {
            "type": "boolean",
            "description": "Whether all signatures in the template must use a qualified timestamp server. Optional. When omitted, the value `false` is applied at the downstream Nova boundary.",
            "nullable": true,
            "example": true
          },
          "signatureReason": {
            "type": "string",
            "description": "The signature reason persisted on the template. Null or omitted overwrites the persisted value to null (full PUT semantics).",
            "nullable": true,
            "example": "Approved by Mario Rossi"
          },
          "signatureFormat": {
            "$ref": "#/components/schemas/SignatureFormat"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Agreement"
            },
            "description": "The agreements per language. Null means no change (keep existing); empty list clears all agreements.",
            "nullable": true
          },
          "fileRestrictedVisibility": {
            "type": "boolean",
            "description": "Whether file visibility is restricted per recipient. Null means no change.",
            "nullable": true,
            "example": false
          },
          "afterSendRedirectUrl": {
            "type": "string",
            "description": "The URL to redirect to after sending the envelope. Null or omitted overwrites the persisted value to null (full PUT semantics).",
            "nullable": true,
            "example": "https://example.com/envelope-sent"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a template."
      },
      "UpdateTemplateStageRequest": {
        "required": [
          "name",
          "requiredRecipientCompletions",
          "type"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The stage name.",
            "example": "Updated Stage Name"
          },
          "requiredRecipientCompletions": {
            "type": "integer",
            "description": "Number of recipients required to complete the stage.",
            "format": "int32",
            "example": 1
          },
          "type": {
            "$ref": "#/components/schemas/StageType"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a stage."
      },
      "UpdateTemplateStandardRecipientRequest": {
        "required": [
          "type"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/UpdateTemplateRecipientRequest"
          },
          {
            "required": [
              "email",
              "givenName",
              "notificationChannels",
              "phoneNumber",
              "surname"
            ],
            "type": "object",
            "properties": {
              "givenName": {
                "type": "string",
                "description": "The recipient's first name.",
                "nullable": true
              },
              "surname": {
                "type": "string",
                "description": "The recipient's last name.",
                "nullable": true
              },
              "email": {
                "type": "string",
                "description": "The recipient's email address.",
                "nullable": true
              },
              "phoneNumber": {
                "type": "string",
                "description": "The recipient's phone number.",
                "nullable": true
              },
              "notificationChannels": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/NotificationChannel"
                },
                "description": "Channels used to notify the recipient.",
                "nullable": true
              },
              "authentication": {
                "$ref": "#/components/schemas/UpdateRecipientAuthentication"
              },
              "signatureConfiguration": {
                "$ref": "#/components/schemas/UpdateRecipientSignatureData"
              },
              "personalMessage": {
                "type": "string",
                "description": "A personal message included in the notification.",
                "nullable": true
              },
              "metadata": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RecipientMetadataEntry"
                },
                "description": "Recipient-level metadata injected into the workstep XML as additional client workstep information.",
                "nullable": true
              },
              "signatureReason": {
                "type": "string",
                "description": "Reason displayed at the recipient signing step.",
                "nullable": true,
                "example": "I agree to the terms."
              },
              "isSignatureReasonEditable": {
                "type": "boolean",
                "description": "Whether the recipient is allowed to edit the signature reason at signing time.",
                "nullable": true,
                "example": false
              }
            },
            "additionalProperties": false
          }
        ],
        "properties": {
          "type": {
            "enum": [
              "Standard"
            ],
            "type": "string",
            "default": "Standard"
          }
        },
        "description": "Request body for updating a Standard recipient."
      },
      "UpdateUserApplicationRolesRequest": {
        "required": [
          "applicationRoles"
        ],
        "type": "object",
        "properties": {
          "applicationRoles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserApplicationRoleRequest"
            },
            "description": "The full set of application roles to assign to the user. Replaces any existing assignment."
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating the application roles assigned to a user within an organization."
      },
      "UpdateUserGroupContactCustomFieldRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The contact custom field name.",
            "example": "Tax code"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a contact custom field."
      },
      "UpdateUserGroupContactRequest": {
        "type": "object",
        "properties": {
          "givenName": {
            "type": "string",
            "description": "The contact's first name.",
            "nullable": true,
            "example": "John"
          },
          "surname": {
            "type": "string",
            "description": "The contact's last name.",
            "nullable": true,
            "example": "Smith"
          },
          "email": {
            "type": "string",
            "description": "The contact's email address.",
            "nullable": true,
            "example": "john.smith@example.com"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The contact's phone number.",
            "nullable": true,
            "example": "+44 20 7946 0958"
          },
          "language": {
            "type": "string",
            "description": "The contact's culture ISO code.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": {},
        "description": "Request body that replaces a contact of a user group. The contact is replaced as a whole: a standard field\nthat is not sent is cleared, and so is a custom field. The values of the group's custom fields are sent as\nadditional properties next to the standard fields, keyed by custom field name (e.g. `\"Tax code\": \"AB123456C\"`)."
      },
      "UpdateUserGroupContactsPermissionRequest": {
        "type": "object",
        "properties": {
          "read": {
            "type": "boolean",
            "description": "Whether the user has permission to read contacts.\n\n_optional: omission ignores property_"
          },
          "createUpdateDelete": {
            "type": "boolean",
            "description": "Whether the user has permission to create, update, and delete contacts.\n\n_optional: omission ignores property_"
          },
          "customize": {
            "type": "boolean",
            "description": "Whether the user has permission to customize contacts.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Contacts management permissions."
      },
      "UpdateUserGroupContactsPermissionRequestOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateUserGroupContactsPermissionRequest"
          }
        },
        "additionalProperties": false
      },
      "UpdateUserGroupEnvelopesPermissionRequest": {
        "type": "object",
        "properties": {
          "share": {
            "type": "boolean",
            "description": "Whether the user has permission to share envelopes.\n\n_optional: omission ignores property_"
          },
          "manage": {
            "type": "boolean",
            "description": "Whether the user has permission to manage envelopes.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Envelopes management permissions."
      },
      "UpdateUserGroupEnvelopesPermissionRequestOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateUserGroupEnvelopesPermissionRequest"
          }
        },
        "additionalProperties": false
      },
      "UpdateUserGroupPermissionRequest": {
        "type": "object",
        "properties": {
          "users": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateUserGroupUsersPermissionRequest"
              }
            ],
            "description": "Users management permissions to update.\n\n_optional: omission ignores property_"
          },
          "envelopes": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateUserGroupEnvelopesPermissionRequest"
              }
            ],
            "description": "Envelopes management permissions to update.\n\n_optional: omission ignores property_"
          },
          "templates": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateUserGroupTemplatesPermissionRequest"
              }
            ],
            "description": "Templates management permissions to update.\n\n_optional: omission ignores property_"
          },
          "contacts": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateUserGroupContactsPermissionRequest"
              }
            ],
            "description": "Contacts management permissions to update.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Permissions for a user in a group."
      },
      "UpdateUserGroupPermissionRequestOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateUserGroupPermissionRequest"
          }
        },
        "additionalProperties": false
      },
      "UpdateUserGroupRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The user group name.",
            "example": "Sales Team"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a user group."
      },
      "UpdateUserGroupTemplatesPermissionRequest": {
        "type": "object",
        "properties": {
          "share": {
            "type": "boolean",
            "description": "Whether the user has permission to share templates.\n\n_optional: omission ignores property_"
          },
          "manage": {
            "type": "boolean",
            "description": "Whether the user has permission to manage templates.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Templates management permissions."
      },
      "UpdateUserGroupTemplatesPermissionRequestOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateUserGroupTemplatesPermissionRequest"
          }
        },
        "additionalProperties": false
      },
      "UpdateUserGroupUserRequest": {
        "type": "object",
        "properties": {
          "permissions": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UpdateUserGroupPermissionRequest"
              }
            ],
            "description": "Optional permissions to update.\n\n_optional: omission ignores property_"
          },
          "businessRoleId": {
            "type": "string",
            "description": "Optional business role ID to update.\n\n_optional: `null` sets to null, omission ignores property_",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Request to update a user in a group (permissions and/or role)."
      },
      "UpdateUserGroupUsersPermissionRequest": {
        "type": "object",
        "properties": {
          "read": {
            "type": "boolean",
            "description": "Whether the user has permission to read users.\n\n_optional: omission ignores property_"
          },
          "createUpdateDelete": {
            "type": "boolean",
            "description": "Whether the user has permission to create, update, and delete users.\n\n_optional: omission ignores property_"
          }
        },
        "additionalProperties": false,
        "description": "Users management permissions."
      },
      "UpdateUserGroupUsersPermissionRequestOptional": {
        "required": [
          "isSet",
          "value"
        ],
        "type": "object",
        "properties": {
          "isSet": {
            "type": "boolean",
            "readOnly": true
          },
          "value": {
            "$ref": "#/components/schemas/UpdateUserGroupUsersPermissionRequest"
          }
        },
        "additionalProperties": false
      },
      "UpdateUserRequest": {
        "required": [
          "givenName",
          "regionalSettings",
          "surname"
        ],
        "type": "object",
        "properties": {
          "givenName": {
            "type": "string",
            "description": "The user's first name.",
            "example": "Mario"
          },
          "surname": {
            "type": "string",
            "description": "The user's last name.",
            "example": "Rossi"
          },
          "regionalSettings": {
            "$ref": "#/components/schemas/UserRegionalSettingsRequest"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The user's optional phone number. Pass null to remove the phone number.",
            "nullable": true,
            "example": "+39021234567"
          }
        },
        "additionalProperties": false,
        "description": "Request body for updating a user within an organization."
      },
      "UploadBulkEnvelopeFileResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the uploaded file.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000020"
          }
        },
        "additionalProperties": false,
        "description": "Response after uploading a bulk envelope file."
      },
      "UploadEnvelopeFileResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the uploaded file.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000020"
          }
        },
        "additionalProperties": false,
        "description": "Response after uploading a file."
      },
      "UploadTemplateFileResponse": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the uploaded file.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Response after uploading a file."
      },
      "UserApplicationRoleRequest": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The application role ID.",
            "format": "uuid",
            "example": "550e8400-e29b-41d4-a716-446655440000"
          }
        },
        "additionalProperties": false,
        "description": "Reference to an application role to assign to a user."
      },
      "UserGroupContactCustomFieldListResponse": {
        "required": [
          "customFields"
        ],
        "type": "object",
        "properties": {
          "customFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserGroupContactCustomFieldSummary"
            },
            "description": "The custom fields of the group."
          }
        },
        "additionalProperties": false,
        "description": "List of the custom fields defined for the contacts of a user group."
      },
      "UserGroupContactCustomFieldSummary": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the contact custom field. Use this ID to retrieve, update, or delete the field.",
            "format": "uuid",
            "example": "400658ab-5f75-43c3-aff1-1ca6a046d9fa"
          },
          "name": {
            "type": "string",
            "description": "The custom field name.",
            "example": "Tax code"
          }
        },
        "additionalProperties": false,
        "description": "Custom field defined for the contacts of a user group."
      },
      "UserGroupContactListResponse": {
        "required": [
          "contacts",
          "pagination"
        ],
        "type": "object",
        "properties": {
          "contacts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserGroupContactSummary"
            },
            "description": "The contacts of the group."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of the contacts shared in a user group."
      },
      "UserGroupContactSummary": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The contact ID.",
            "format": "uuid",
            "example": "e201ace1-7752-4a33-a9b3-2a46902e8de3"
          },
          "email": {
            "type": "string",
            "description": "The contact's email address.",
            "nullable": true,
            "example": "john.smith@example.com"
          },
          "givenName": {
            "type": "string",
            "description": "The contact's first name.",
            "nullable": true,
            "example": "John"
          },
          "surname": {
            "type": "string",
            "description": "The contact's last name.",
            "nullable": true,
            "example": "Smith"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The contact's phone number.",
            "nullable": true,
            "example": "+44 20 7946 0958"
          },
          "language": {
            "type": "string",
            "description": "The contact's culture ISO code.",
            "nullable": true,
            "example": "en"
          }
        },
        "additionalProperties": {},
        "description": "Summary representation of a contact shared in a user group."
      },
      "UserGroupContactsPermission": {
        "required": [
          "createUpdateDelete",
          "customize",
          "read"
        ],
        "type": "object",
        "properties": {
          "read": {
            "type": "boolean",
            "description": "Whether the user has permission to read contacts."
          },
          "createUpdateDelete": {
            "type": "boolean",
            "description": "Whether the user has permission to create, update, and delete contacts."
          },
          "customize": {
            "type": "boolean",
            "description": "Whether the user has permission to customize contacts."
          }
        },
        "additionalProperties": false,
        "description": "Contacts management permissions."
      },
      "UserGroupEnvelopesPermission": {
        "required": [
          "manage",
          "share"
        ],
        "type": "object",
        "properties": {
          "share": {
            "type": "boolean",
            "description": "Whether the user has permission to share envelopes."
          },
          "manage": {
            "type": "boolean",
            "description": "Whether the user has permission to manage envelopes."
          }
        },
        "additionalProperties": false,
        "description": "Envelopes management permissions."
      },
      "UserGroupListResponse": {
        "required": [
          "pagination",
          "userGroups"
        ],
        "type": "object",
        "properties": {
          "userGroups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserGroupSummary"
            },
            "description": "The list of user groups."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of user groups."
      },
      "UserGroupPermission": {
        "required": [
          "contacts",
          "envelopes",
          "templates",
          "users"
        ],
        "type": "object",
        "properties": {
          "users": {
            "$ref": "#/components/schemas/UserGroupUsersPermission"
          },
          "envelopes": {
            "$ref": "#/components/schemas/UserGroupEnvelopesPermission"
          },
          "templates": {
            "$ref": "#/components/schemas/UserGroupTemplatesPermission"
          },
          "contacts": {
            "$ref": "#/components/schemas/UserGroupContactsPermission"
          }
        },
        "additionalProperties": false,
        "description": "Permissions for a user in a group."
      },
      "UserGroupSummary": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The user group ID.",
            "format": "uuid",
            "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          },
          "name": {
            "type": "string",
            "description": "The user group name.",
            "example": "Sales Team"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a user group."
      },
      "UserGroupTemplatesPermission": {
        "required": [
          "manage",
          "share"
        ],
        "type": "object",
        "properties": {
          "share": {
            "type": "boolean",
            "description": "Whether the user has permission to share templates."
          },
          "manage": {
            "type": "boolean",
            "description": "Whether the user has permission to manage templates."
          }
        },
        "additionalProperties": false,
        "description": "Templates management permissions."
      },
      "UserGroupUserListResponse": {
        "required": [
          "pagination",
          "users"
        ],
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserGroupUserSummary"
            },
            "description": "The list of users in the group."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of users in a user group."
      },
      "UserGroupUserResponse": {
        "required": [
          "id",
          "permissions"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The user ID.",
            "format": "uuid"
          },
          "permissions": {
            "$ref": "#/components/schemas/UserGroupPermission"
          },
          "businessRoleId": {
            "type": "string",
            "description": "The assigned business role ID, if any.",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a user in a user group (excludes businessRole)."
      },
      "UserGroupUserSummary": {
        "required": [
          "email",
          "givenName",
          "id",
          "surname"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The user ID.",
            "format": "uuid"
          },
          "email": {
            "type": "string",
            "description": "The user's email address."
          },
          "givenName": {
            "type": "string",
            "description": "The user's first name."
          },
          "surname": {
            "type": "string",
            "description": "The user's last name."
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a user in a user group (excludes identity fields)."
      },
      "UserGroupUsersPermission": {
        "required": [
          "createUpdateDelete",
          "read"
        ],
        "type": "object",
        "properties": {
          "read": {
            "type": "boolean",
            "description": "Whether the user has permission to read users."
          },
          "createUpdateDelete": {
            "type": "boolean",
            "description": "Whether the user has permission to create, update, and delete users."
          }
        },
        "additionalProperties": false,
        "description": "Users management permissions."
      },
      "UserGroupsSortingKey": {
        "enum": [
          "Name"
        ],
        "type": "string",
        "description": "The available sorting keys for listing user groups."
      },
      "UserListResponse": {
        "required": [
          "pagination",
          "users"
        ],
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserSummary"
            },
            "description": "The list of users."
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationResponse"
          }
        },
        "additionalProperties": false,
        "description": "Paginated list of users."
      },
      "UserRegionalSettingsRequest": {
        "required": [
          "country",
          "dateTimeFormat",
          "language",
          "timeZone"
        ],
        "type": "object",
        "properties": {
          "timeZone": {
            "type": "string",
            "description": "The IANA time zone identifier.",
            "example": "Europe/Berlin"
          },
          "dateTimeFormat": {
            "$ref": "#/components/schemas/DateTimeFormat"
          },
          "language": {
            "type": "string",
            "description": "BCP 47 language code.",
            "example": "en"
          },
          "country": {
            "type": "string",
            "description": "The ISO 3166-1 alpha-2 country code.",
            "example": "IT"
          }
        },
        "additionalProperties": false,
        "description": "Regional settings for a new user."
      },
      "UserRegionalSettingsResponse": {
        "required": [
          "country",
          "dateTimeFormat",
          "language",
          "timeZone"
        ],
        "type": "object",
        "properties": {
          "timeZone": {
            "type": "string",
            "description": "The IANA time zone identifier.",
            "example": "Europe/Berlin"
          },
          "language": {
            "type": "string",
            "description": "BCP 47 language code.",
            "example": "it"
          },
          "country": {
            "type": "string",
            "description": "The ISO 3166-1 alpha-2 country code.",
            "example": "IT"
          },
          "dateTimeFormat": {
            "type": "string",
            "description": "The date and time display format string.",
            "example": "dd/MM/yyyy | HH:mm"
          }
        },
        "additionalProperties": false,
        "description": "Regional settings returned for a user."
      },
      "UserResponse": {
        "required": [
          "email",
          "givenName",
          "id",
          "surname"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The user's unique identifier.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          },
          "givenName": {
            "type": "string",
            "description": "The user's first name.",
            "example": "Mario"
          },
          "surname": {
            "type": "string",
            "description": "The user's last name.",
            "example": "Rossi"
          },
          "email": {
            "type": "string",
            "description": "The user's email address.",
            "example": "mario.rossi@example.com"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The user's optional phone number.",
            "nullable": true,
            "example": "+39021234567"
          },
          "regionalSettings": {
            "$ref": "#/components/schemas/UserRegionalSettingsResponse"
          }
        },
        "additionalProperties": false,
        "description": "Detailed representation of a user."
      },
      "UserSortingKey": {
        "enum": [
          "GivenName",
          "Surname",
          "Email"
        ],
        "type": "string",
        "description": "Sorting keys available when listing users in an organization."
      },
      "UserSummary": {
        "required": [
          "email",
          "givenName",
          "id",
          "surname"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The user identifier.",
            "format": "uuid",
            "example": "00000000-0000-0000-0000-000000000001"
          },
          "givenName": {
            "type": "string",
            "description": "The user's given name.",
            "example": "Mario"
          },
          "surname": {
            "type": "string",
            "description": "The user's surname.",
            "example": "Rossi"
          },
          "email": {
            "type": "string",
            "description": "The user's email address.",
            "example": "mario.rossi@example.com"
          },
          "phoneNumber": {
            "type": "string",
            "description": "The user's phone number, if set.",
            "nullable": true,
            "example": "+39 02 1234567"
          }
        },
        "additionalProperties": false,
        "description": "Summary representation of a user."
      },
      "VerifyEnvelopePoliciesResponse": {
        "required": [
          "compliant"
        ],
        "type": "object",
        "properties": {
          "compliant": {
            "type": "boolean",
            "description": "Whether the envelope satisfies all applicable document class policies."
          }
        },
        "additionalProperties": false,
        "description": "Response from verifying envelope policies."
      },
      "WebhookAuthenticationRequest": {
        "type": "object",
        "properties": {
          "headers": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional HTTP headers to include in webhook calls.",
            "nullable": true
          },
          "clientCertificate": {
            "type": "string",
            "description": "Optional PEM-encoded client certificate for mTLS.",
            "nullable": true
          },
          "clientKey": {
            "type": "string",
            "description": "Optional PEM-encoded private key for mTLS.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Authentication settings for the webhook endpoint."
      },
      "WebhookAuthenticationResponse": {
        "type": "object",
        "properties": {
          "headers": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "HTTP headers sent with the webhook calls; the values are obfuscated.",
            "nullable": true
          },
          "clientCertificate": {
            "type": "string",
            "description": "Obfuscated client certificate, when configured.",
            "nullable": true
          },
          "clientKey": {
            "type": "string",
            "description": "Obfuscated client key, when configured.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Authentication settings of a webhook. Header names are returned as-is, every secret value is obfuscated with asterisks."
      },
      "WebhookEventType": {
        "enum": [
          "EnvelopeSent",
          "EnvelopeCompleted",
          "EnvelopeCanceled",
          "EnvelopeRestarted",
          "EnvelopeDeleted",
          "RecipientCompleted",
          "RecipientRejected",
          "RecipientDelegated"
        ],
        "type": "string",
        "description": "Events a webhook can be configured for. Envelope webhooks support every event, organization webhooks only EnvelopeCompleted."
      },
      "WebhookSubscriptionResponse": {
        "required": [
          "createdAt",
          "hasClientCertificate",
          "hasHeaders",
          "id",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The subscription ID.",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "description": "The webhook delivery URL."
          },
          "hasHeaders": {
            "type": "boolean",
            "description": "Whether custom headers are configured."
          },
          "hasClientCertificate": {
            "type": "boolean",
            "description": "Whether mTLS is configured."
          },
          "createdAt": {
            "type": "string",
            "description": "When the subscription was created.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Response model for a webhook subscription."
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Unauthorized",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsResponse"
            }
          }
        }
      },
      "Forbidden": {
        "description": "Forbidden",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsResponse"
            }
          }
        }
      },
      "NotFound": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsResponse"
            }
          }
        }
      },
      "InternalServerError": {
        "description": "Internal Server Error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsResponse"
            }
          }
        }
      }
    },
    "parameters": {
      "organizationId": {
        "name": "organizationId",
        "in": "path",
        "description": "Unique identifier of the organization",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "envelopeId": {
        "name": "envelopeId",
        "in": "path",
        "description": "Unique identifier of the envelope",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "templateId": {
        "name": "templateId",
        "in": "path",
        "description": "Unique identifier of the template",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "stageId": {
        "name": "stageId",
        "in": "path",
        "description": "Unique identifier of the stage",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "fileId": {
        "name": "fileId",
        "in": "path",
        "description": "Unique identifier of the file",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "recipientId": {
        "name": "recipientId",
        "in": "path",
        "description": "Unique identifier of the recipient",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "artifactId": {
        "name": "artifactId",
        "in": "path",
        "description": "Unique identifier of the artifact",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "userId": {
        "name": "userId",
        "in": "path",
        "description": "Unique identifier of the user",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "userGroupId": {
        "name": "userGroupId",
        "in": "path",
        "description": "Unique identifier of the user group",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "applicationRoleId": {
        "name": "applicationRoleId",
        "in": "path",
        "description": "Unique identifier of the application role",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "businessRoleId": {
        "name": "businessRoleId",
        "in": "path",
        "description": "Unique identifier of the business role",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "webhookId": {
        "name": "webhookId",
        "in": "path",
        "description": "Unique identifier of the webhook",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "Insert your JWT Bearer token from MyNamirial",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "PersonalAccessToken": {
        "type": "apiKey",
        "description": "Personal Access Token authentication. Provide a token prefixed with 'nse_pat_'.",
        "name": "Personal-Access-Token",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "Bearer": []
    },
    {
      "PersonalAccessToken": []
    }
  ],
  "tags": [
    {
      "name": "Application Reference Data"
    },
    {
      "name": "Bulk Envelope"
    },
    {
      "name": "Bulk Envelope Action"
    },
    {
      "name": "Bulk Envelope Detail"
    },
    {
      "name": "Bulk Envelope File"
    },
    {
      "name": "Bulk Envelope File Task"
    },
    {
      "name": "Bulk Envelope Stage"
    },
    {
      "name": "Bulk Envelope Stage Recipient"
    },
    {
      "name": "Document Class"
    },
    {
      "name": "Document Metadata"
    },
    {
      "name": "Envelope",
      "description": "Operations for managing envelopes."
    },
    {
      "name": "Envelope Action",
      "description": "Actions to control the envelope lifecycle."
    },
    {
      "name": "Envelope Detail",
      "description": "Events and artifacts of an envelope."
    },
    {
      "name": "Envelope File",
      "description": "Files of an envelope."
    },
    {
      "name": "Envelope File Task",
      "description": "Tasks defined on a file of an envelope."
    },
    {
      "name": "Envelope Stage",
      "description": "Stages of an envelope."
    },
    {
      "name": "Envelope Stage Recipient",
      "description": "Recipients of a stage of an envelope."
    },
    {
      "name": "Organization Settings Envelope",
      "description": "Organization-level envelope agreement settings."
    },
    {
      "name": "Organization Settings General",
      "description": "Organization-level general, language and regional settings."
    },
    {
      "name": "Organization Settings Recipient",
      "description": "Organization-level recipient settings and OAuth providers."
    },
    {
      "name": "Organization Settings Signature",
      "description": "Organization-level signature settings and signature layouts."
    },
    {
      "name": "Organization Settings User",
      "description": "Organization-level business roles and application roles."
    },
    {
      "name": "Policy"
    },
    {
      "name": "Template",
      "description": "Operations for managing templates."
    },
    {
      "name": "Template Action",
      "description": "Actions to create envelopes from templates."
    },
    {
      "name": "Template File",
      "description": "Files of a template."
    },
    {
      "name": "Template File Task",
      "description": "Tasks defined on a file of a template."
    },
    {
      "name": "Template Stage",
      "description": "Stages of a template."
    },
    {
      "name": "Template Stage Recipient",
      "description": "Recipients of a stage of a template."
    },
    {
      "name": "User"
    },
    {
      "name": "User Group"
    },
    {
      "name": "Webhook"
    }
  ]
}