---
updatedAt: 2026-10-19T13:54:43.000Z
agentTools:
  projectIndex: https://developers.youtrust.com/llms.txt
---

# Create a new Signer

Adds a Signer to a given Signature Request.

A Signer can be created:

* from scratch
* from an existing Contact
* from an existing User

**Limits:** a maximum of 100 Signers can be added per Signature Request.

Related guide: [Signer](https://developers.youtrust.com/docs/signer-1)

***

**🔓 Endpoint access**

* Environments: `production`, `sandbox`
* API key scopes: `organization`, `workspace`
* Plans: `plus`, `pro`, `scale`
* Add-ons (for production access): `Simple Electronic Signature` or `Advanced Electronic Signature` or `Qualified Electronic Signature`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "contact": {
      "email": "contact@youtrust.com",
      "name": "Support",
      "url": "https://youtrust.com/contact"
    },
    "description": "Build the best experience of digital signature through your own platform. Increase your conversion rates, leverage your data and reduce your costs with Youtrust API.",
    "license": {
      "name": "proprietary",
      "url": "https://youtrust.com/terms"
    },
    "title": "Public Api v3",
    "version": "3.0"
  },
  "servers": [
    {
      "description": "Sandbox URL",
      "url": "https://api-sandbox.yousign.app/v3"
    },
    {
      "description": "Production URL",
      "url": "https://api.yousign.app/v3"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "description": "Person who will sign a Signature Request.",
      "name": "Signer"
    }
  ],
  "paths": {
    "/signature_requests/{signatureRequestId}/signers": {
      "post": {
        "description": "Adds a Signer to a given Signature Request.",
        "operationId": "post-signature_requests-signatureRequestId-signers",
        "parameters": [
          {
            "description": "Signature Request Id",
            "in": "path",
            "name": "signatureRequestId",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/UUID"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSigner"
              }
            }
          }
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Signer"
                }
              }
            },
            "description": "Created",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "smart_anchor_identifier_not_allowed": {
                    "summary": "[Available soon] Smart Anchor identifier refused on this Signature Request or Signer",
                    "value": {
                      "type": "smart_anchor.identifier_not_allowed",
                      "detail": "A Smart Anchor identifier can only be set on a Signature Request whose smart anchors resolution is \"on_match\"."
                    }
                  },
                  "smart_anchor_identifier_already_used": {
                    "summary": "[Available soon] Smart Anchor identifier held by another Signer",
                    "value": {
                      "type": "smart_anchor.identifier_already_used",
                      "detail": "The Smart Anchor identifier \"s1\" is already held by another Signer of this Signature Request."
                    }
                  },
                  "resource_not_available": {
                    "summary": "[Available soon] The Signature Request is locked by a concurrent request binding a Smart Anchor identifier; retry later",
                    "value": {
                      "type": "resource.not_available",
                      "detail": "Resource not available, please retry later."
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/CreateSignerBadRequestResponse"
                }
              }
            },
            "description": "Bad request",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnauthorizedResponse"
                }
              }
            },
            "description": "Access unauthorized",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ForbiddenResponse"
                }
              }
            },
            "description": "Access forbidden",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotFoundResponse"
                }
              }
            },
            "description": "Resource not found",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MethodNotAllowed"
                }
              }
            },
            "description": "This method is not allowed",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              },
              "Retry-After": {
                "$ref": "#/components/headers/retry-after"
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnsupportedMediaTypeResponse"
                }
              }
            },
            "description": "UnsupportedMediaType",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TooManyRequestsResponse"
                }
              }
            },
            "description": "Too Many Requests, please try again later.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              },
              "Retry-After": {
                "$ref": "#/components/headers/retry-after"
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InternalServerError"
                }
              }
            },
            "description": "Internal Server Error",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/rateLimit-limit"
              },
              "X-RateLimit-Limit-Hour": {
                "$ref": "#/components/headers/rateLimit-limit-hour"
              },
              "X-RateLimit-Limit-Minute": {
                "$ref": "#/components/headers/rateLimit-limit-minute"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/rateLimit-remaining"
              },
              "X-RateLimit-Remaining-Hour": {
                "$ref": "#/components/headers/rateLimit-remaining-hour"
              },
              "X-RateLimit-Remaining-Minute": {
                "$ref": "#/components/headers/rateLimit-remaining-minute"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/rateLimit-reset"
              }
            }
          }
        },
        "summary": "Create a new Signer",
        "tags": [
          "Signer"
        ]
      }
    }
  },
  "components": {
    "headers": {
      "rateLimit-limit": {
        "description": "The maximum number of requests that the consumer is permitted to make in a given period",
        "schema": {
          "type": "integer"
        }
      },
      "rateLimit-limit-hour": {
        "description": "The maximum number of requests that the consumer is permitted to make in an hour window",
        "schema": {
          "type": "integer"
        }
      },
      "rateLimit-limit-minute": {
        "description": "The maximum number of requests that the consumer is permitted to make in an minute window",
        "schema": {
          "type": "integer"
        }
      },
      "rateLimit-remaining": {
        "description": "The number of requests remaining in the current rate limit window",
        "schema": {
          "type": "integer"
        }
      },
      "rateLimit-remaining-hour": {
        "description": "The number of requests remaining in the current hour rate limit window",
        "schema": {
          "type": "integer"
        }
      },
      "rateLimit-remaining-minute": {
        "description": "The number of requests remaining in the current minute rate limit window",
        "schema": {
          "type": "integer"
        }
      },
      "rateLimit-reset": {
        "description": "The remaining time until the rate limit resets in seconds",
        "schema": {
          "type": "integer"
        }
      },
      "retry-after": {
        "description": "Retry the request after X seconds",
        "schema": {
          "type": "integer"
        }
      }
    },
    "schemas": {
      "UUID": {
        "description": "The unique identifier for a resource.",
        "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
        "format": "uuid",
        "type": "string"
      },
      "FieldSignature": {
        "properties": {
          "id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "document_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "signer_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "enum": [
              "signature"
            ],
            "type": "string"
          },
          "height": {
            "format": "int32",
            "maximum": 1000,
            "minimum": 37,
            "type": "integer"
          },
          "width": {
            "format": "int32",
            "maximum": 2000,
            "minimum": 85,
            "type": "integer"
          },
          "page": {
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "reason": {
            "allOf": [
              {
                "$ref": "#/components/schemas/HumanName"
              }
            ],
            "maxLength": 150,
            "nullable": true,
            "type": "string"
          },
          "display": {
            "$ref": "#/components/schemas/SignatureDisplay"
          }
        },
        "required": [
          "display",
          "document_id",
          "height",
          "id",
          "page",
          "reason",
          "signer_id",
          "type",
          "width",
          "x",
          "y"
        ],
        "title": "Signature",
        "type": "object"
      },
      "FieldText": {
        "properties": {
          "id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "document_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "signer_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "enum": [
              "text"
            ],
            "type": "string"
          },
          "width": {
            "description": "If not set, the width is automatically calculated with the max_length value",
            "example": 90,
            "format": "int32",
            "minimum": 24,
            "type": "integer"
          },
          "height": {
            "description": "The height must be calculated using the formula: \"height = number_of_lines \\* font_size \\* line_height\", where the line height is always set to 1.5.",
            "example": 150,
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "page": {
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "question": {
            "example": "What is your job title?",
            "maxLength": 255,
            "type": "string"
          },
          "instruction": {
            "example": "Your position in the company",
            "nullable": true,
            "type": "string"
          },
          "optional": {
            "type": "boolean"
          },
          "answer": {
            "example": "Software Engineer",
            "nullable": true,
            "type": "string"
          },
          "max_length": {
            "maximum": 32767,
            "minimum": 1,
            "type": "integer"
          },
          "font": {
            "$ref": "#/components/schemas/Font"
          },
          "name": {
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "default_value": {
            "maxLength": 32767,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "read_only": {
            "type": "boolean"
          }
        },
        "required": [
          "answer",
          "document_id",
          "font",
          "height",
          "id",
          "instruction",
          "max_length",
          "optional",
          "page",
          "question",
          "signer_id",
          "type",
          "width",
          "x",
          "y"
        ],
        "title": "Text",
        "type": "object"
      },
      "FieldMention": {
        "properties": {
          "id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "document_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "signer_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "enum": [
              "mention"
            ],
            "type": "string"
          },
          "height": {
            "description": "The height must be calculated using the formula: \"height = number_of_lines \\* font_size \\* line_height\", where the line height is always set to 1.5.",
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "width": {
            "format": "int32",
            "minimum": 24,
            "type": "integer"
          },
          "page": {
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "mention": {
            "type": "string"
          },
          "font": {
            "$ref": "#/components/schemas/Font"
          },
          "name": {
            "description": "Name of the Field.",
            "example": "Mention 1",
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "document_id",
          "font",
          "height",
          "id",
          "mention",
          "page",
          "signer_id",
          "type",
          "width",
          "x",
          "y"
        ],
        "title": "Mention",
        "type": "object"
      },
      "FieldCheckbox": {
        "properties": {
          "id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "document_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "signer_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "enum": [
              "checkbox"
            ],
            "type": "string"
          },
          "name": {
            "description": "Checkbox name",
            "example": "Checkbox name",
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "checked": {
            "description": "Signer has checked the checkbox",
            "type": "boolean"
          },
          "page": {
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "optional": {
            "type": "boolean"
          },
          "x": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "size": {
            "description": "The size determines both the width and height of the checkbox.",
            "format": "int32",
            "maximum": 240,
            "minimum": 8,
            "type": "integer"
          }
        },
        "required": [
          "checked",
          "document_id",
          "id",
          "name",
          "optional",
          "page",
          "signer_id",
          "type",
          "x",
          "y"
        ],
        "title": "Checkbox",
        "type": "object"
      },
      "FieldRadioButtonGroup": {
        "properties": {
          "id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "document_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "signer_id": {
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "enum": [
              "radio_group"
            ],
            "type": "string"
          },
          "page": {
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "optional": {
            "description": "Does the Signer has to select one of the radio buttons from this group?",
            "type": "boolean"
          },
          "name": {
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "radios": {
            "items": {
              "$ref": "#/components/schemas/FieldRadioButtonGroup_radios_inner"
            },
            "type": "array"
          }
        },
        "required": [
          "document_id",
          "id",
          "name",
          "optional",
          "page",
          "radios",
          "signer_id",
          "type"
        ],
        "title": "RadioGroup",
        "type": "object"
      },
      "Signer": {
        "description": "Signer",
        "properties": {
          "id": {
            "format": "uuid",
            "minLength": 1,
            "type": "string"
          },
          "info": {
            "$ref": "#/components/schemas/Signer_info"
          },
          "identity_pool": {
            "description": "The members of the group, who can sign on behalf of the group. `null` when the Signer is a single person (see `info`).",
            "items": {
              "$ref": "#/components/schemas/Signer_identity_pool_inner"
            },
            "nullable": true,
            "type": "array"
          },
          "status": {
            "enum": [
              "initiated",
              "declined",
              "notified",
              "verified",
              "processing",
              "consent_given",
              "signed",
              "aborted",
              "error"
            ],
            "minLength": 1,
            "type": "string"
          },
          "fields": {
            "items": {
              "$ref": "#/components/schemas/Signer_fields_inner"
            },
            "nullable": true,
            "type": "array"
          },
          "signature_level": {
            "default": "electronic_signature",
            "enum": [
              "electronic_signature",
              "advanced_electronic_signature",
              "qualified_electronic_signature"
            ],
            "type": "string"
          },
          "signature_authentication_mode": {
            "description": "Method to authenticate the Signers. Authentication via SMS one-time password (otp_sms) is unavailable for phone numbers in China.",
            "enum": [
              null,
              "otp_email",
              "otp_sms",
              "no_otp"
            ],
            "nullable": true,
            "type": "string"
          },
          "signature_link": {
            "format": "uri",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "signature_link_expiration_date": {
            "example": "2024-01-18T22:59:00Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "signature_image_preview": {
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "redirect_urls": {
            "$ref": "#/components/schemas/Signer_redirect_urls"
          },
          "custom_text": {
            "$ref": "#/components/schemas/CustomText"
          },
          "delivery_mode": {
            "enum": [
              "email",
              "none"
            ],
            "nullable": true,
            "type": "string"
          },
          "identification_attestation_id": {
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "sms_notification": {
            "$ref": "#/components/schemas/SmsNotification"
          },
          "email_notification": {
            "$ref": "#/components/schemas/EmailNotification"
          },
          "pre_identity_verification_required": {
            "type": "boolean"
          },
          "verified_identity_id": {
            "format": "uuid",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "recipient_stage_index": {
            "description": "Position of the recipient in the signing flow. Recipients with the same index are notified simultaneously.",
            "type": "integer"
          },
          "excluded_documents": {
            "description": "List of Document IDs not visible to this Signer.\n",
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          },
          "disabled_signing_contexts": {
            "$ref": "#/components/schemas/DisabledSigningContexts"
          },
          "signed_at": {
            "description": "Timestamp indicating when the Signer completed their signature. Returns null otherwise.",
            "example": "2024-01-18T22:59:00Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "smart_anchor_identifier": {
            "description": "[Available soon] Smart Anchor identifier held by the Signer, null when it holds none.",
            "example": "s1",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "custom_text",
          "delivery_mode",
          "disabled_signing_contexts",
          "email_notification",
          "excluded_documents",
          "fields",
          "id",
          "identification_attestation_id",
          "identity_pool",
          "info",
          "pre_identity_verification_required",
          "recipient_stage_index",
          "redirect_urls",
          "signature_authentication_mode",
          "signature_image_preview",
          "signature_level",
          "signature_link",
          "signature_link_expiration_date",
          "signed_at",
          "smart_anchor_identifier",
          "sms_notification",
          "status",
          "verified_identity_id"
        ],
        "title": "Signer",
        "type": "object"
      },
      "CreateSigner": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/New_Signer_From_Scratch"
          },
          {
            "$ref": "#/components/schemas/New_Signer_From_Existing_User"
          },
          {
            "$ref": "#/components/schemas/New_Signer_From_Existing_Contact"
          },
          {
            "$ref": "#/components/schemas/New_Signer_From_Identity_Verification"
          },
          {
            "$ref": "#/components/schemas/New_Signer_Group"
          }
        ],
        "type": "object"
      },
      "HumanName": {
        "pattern": "^(?!\\s)[0-9A-Za-zĄÀÁÂÃÄÅÇĆÈÉÊËĘÌÍÎÏŁÑŃÒÓÔÕÖŚÙÚÛÜÝŹŻąàáâãäåæçćèéêëęìíîïłñńòóôõöśùúûüýÿźżßĀāĂăĈĉĊċČčĎďĐđĒēĔĕĖėĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹĺĻļĽľĿŀŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵŶŷŸŽžſøØÆȘșȚț`'() -]+(?<!\\s)$",
        "type": "string"
      },
      "Locale": {
        "description": "Locale settings used for communication.",
        "enum": [
          "en",
          "fr",
          "de",
          "it",
          "nl",
          "es",
          "pl",
          "pt",
          "ro"
        ],
        "minLength": 1,
        "title": "Locale",
        "type": "string"
      },
      "SignerDeliveryMode": {
        "description": "Override the delivery mode of the Signature Request for this Signer",
        "enum": [
          "email",
          "none"
        ],
        "nullable": true,
        "type": "string"
      },
      "CustomText": {
        "description": "Custom Text",
        "properties": {
          "request_subject": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 512,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "request_body": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_subject": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 512,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_body": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "reminder_body",
          "reminder_subject",
          "request_body",
          "request_subject"
        ],
        "type": "object"
      },
      "ExcludedDocuments": {
        "description": "List of Document IDs not visible to this Recipient. When omitted, the Recipient can see all Documents. Only available when the document_visibility feature is enabled on the organization.\n",
        "example": [
          "89120884-d29a-4b1a-ac7b-a9e73a872796",
          "7c0c2d1e-3f4a-5b6c-8d9e-0f1a2b3c4d5e"
        ],
        "items": {
          "format": "uuid",
          "type": "string"
        },
        "type": "array"
      },
      "SignatureDisplay": {
        "description": "Controls what is shown within the signature field.",
        "example": {
          "layout": "detailed",
          "options": {
            "date_format": "dd/MM/yyyy",
            "time_format": "HH:mm",
            "show_timezone": true,
            "show_email": false
          }
        },
        "oneOf": [
          {
            "$ref": "#/components/schemas/SignatureDisplay_oneOf"
          },
          {
            "$ref": "#/components/schemas/SignatureDisplay_oneOf_1"
          }
        ],
        "title": "SignatureDisplay",
        "type": "object"
      },
      "Font": {
        "example": {
          "family": "Inconsolata",
          "color": "#F53D1E",
          "size": 12,
          "variants": {
            "bold": true,
            "italic": false
          }
        },
        "properties": {
          "family": {
            "$ref": "#/components/schemas/FontFamily"
          },
          "color": {
            "pattern": "^#([a-f0-9]{6}|[A-F0-9]{6})$",
            "type": "string"
          },
          "size": {
            "maximum": 96,
            "minimum": 7,
            "type": "integer"
          },
          "variants": {
            "$ref": "#/components/schemas/FontVariants"
          }
        },
        "required": [
          "color",
          "family",
          "size",
          "variants"
        ],
        "title": "Font",
        "type": "object"
      },
      "CreateFieldDateFormat": {
        "default": "dd/MM/yyyy",
        "description": "Format used to display the date (e.g., `dd/MM/yyyy`, `MM/dd/yyyy`)",
        "enum": [
          "dd/MM/yyyy",
          "dd-MM-yyyy",
          "dd.MM.yyyy",
          "yyyy-MM-dd",
          "MM/dd/yyyy",
          "dd MMMM yyyy",
          "MMMM dd, yyyy",
          "MMM dd, yyyy"
        ],
        "example": "dd/MM/yyyy",
        "title": "date_format",
        "type": "string"
      },
      "CreateFieldTimeFormat": {
        "description": "Format used to display the time. Can be null to display only the date, or a format like `HH:mm` or `hh:mm a`",
        "enum": [
          null,
          "HH:mm",
          "hh:mm a"
        ],
        "example": "HH:mm",
        "nullable": true,
        "title": "time_format",
        "type": "string"
      },
      "SignatureDisplay_1": {
        "description": "Controls what is shown within the signature field.",
        "nullable": true,
        "oneOf": [
          {
            "$ref": "#/components/schemas/Minimal_layout"
          },
          {
            "$ref": "#/components/schemas/Detailed_layout"
          }
        ],
        "title": "SignatureDisplay",
        "type": "object"
      },
      "SmsNotification": {
        "properties": {
          "otp_message": {
            "$ref": "#/components/schemas/OtpMessage"
          }
        },
        "required": [
          "otp_message"
        ],
        "title": "SMS Notification",
        "type": "object"
      },
      "EmailNotification": {
        "properties": {
          "disabled": {
            "description": "List of disabled email notifications",
            "items": {
              "enum": [
                "signer.signature_request_canceled_due_to_an_error.signer_who_has_not_signed",
                "signer.signature_request_canceled_due_to_an_error.signer_who_has_already_signed",
                "signer.signature_request_canceled_by_sender.signer_who_has_not_signed",
                "signer.signature_request_canceled_by_sender.signer_who_has_already_signed",
                "signer.signature_request_done.signature_request_contains_one_signer",
                "signer.signature_request_done.signature_request_contains_multiple_signers",
                "signer.signature_request_with_multiple_signers_signed.signed_by_a_signer",
                "signer.signature_request_updated.new_expiration_date",
                "signer.signature_request_updated_by_sender.new_signer_details",
                "signer.signature_request_signature_requested.first_notification",
                "signer.signature_request_signature_requested.reminder_to_sign"
              ],
              "type": "string"
            },
            "title": "Disabled email notifications",
            "type": "array"
          }
        },
        "required": [
          "disabled"
        ],
        "title": "Email Notification",
        "type": "object"
      },
      "DisabledSigningContexts": {
        "default": [],
        "description": "Allows you to make Signature Requests unavailable in the contexts specified in this setting.\n",
        "example": [
          "inbox",
          "signature_portal"
        ],
        "items": {
          "enum": [
            "inbox",
            "signature_portal"
          ],
          "type": "string"
        },
        "title": "Disabled Signing Contexts",
        "type": "array"
      },
      "FieldsInput": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/Signature_2"
          },
          {
            "$ref": "#/components/schemas/Mention_2"
          },
          {
            "$ref": "#/components/schemas/Text_2"
          },
          {
            "$ref": "#/components/schemas/Checkbox_2"
          },
          {
            "$ref": "#/components/schemas/RadioGroup_2"
          }
        ],
        "type": "object"
      },
      "SmsNotification_1": {
        "nullable": true,
        "properties": {
          "otp_message": {
            "$ref": "#/components/schemas/OTP_Message"
          }
        },
        "required": [
          "otp_message"
        ],
        "title": "SMS Notification",
        "type": "object"
      },
      "EmailNotification_1": {
        "nullable": true,
        "properties": {
          "disabled": {
            "items": {
              "description": "If the delivery mode is \"email\" for the Signer, you can list all the emails you don't want them to receive.",
              "enum": [
                "signer.signature_request_canceled_due_to_an_error.signer_who_has_not_signed",
                "signer.signature_request_canceled_due_to_an_error.signer_who_has_already_signed",
                "signer.signature_request_canceled_by_sender.signer_who_has_not_signed",
                "signer.signature_request_canceled_by_sender.signer_who_has_already_signed",
                "signer.signature_request_done.signature_request_contains_one_signer",
                "signer.signature_request_done.signature_request_contains_multiple_signers",
                "signer.signature_request_with_multiple_signers_signed.signed_by_a_signer",
                "signer.signature_request_updated.new_expiration_date",
                "signer.signature_request_updated_by_sender.new_signer_details",
                "signer.signature_request_signature_requested.first_notification",
                "signer.signature_request_signature_requested.reminder_to_sign"
              ],
              "type": "string"
            },
            "title": "Disabled Email Notification",
            "type": "array"
          }
        },
        "required": [
          "disabled"
        ],
        "title": "Email Notification",
        "type": "object"
      },
      "SignerSmartAnchorIdentifier": {
        "description": "[Available soon] Smart Anchor identifier (`s1`, `s2`, …) held by this Signer. Only on a Signature Request whose `smart_anchors_resolution` is `on_match`, and unique among its Signers; not on a signer group. The Smart Anchors carrying it on every Document become Fields of this Signer immediately; an identifier that matches no Smart Anchor yet is accepted.\n",
        "example": "s1",
        "maxLength": 19,
        "nullable": true,
        "pattern": "^s[1-9]\\d*$",
        "type": "string"
      },
      "FontFamily": {
        "enum": [
          "Inconsolata",
          "Open Sans",
          "Lato",
          "Raleway",
          "Merriweather",
          "EB Garamond",
          "Comic Neue",
          "Monaco",
          "Helvetica",
          "Courier",
          "Times Roman"
        ],
        "title": "FontFamily",
        "type": "string"
      },
      "FontVariants": {
        "properties": {
          "italic": {
            "default": false,
            "type": "boolean"
          },
          "bold": {
            "default": false,
            "type": "boolean"
          }
        },
        "required": [
          "bold",
          "italic"
        ],
        "title": "FontVariants",
        "type": "object"
      },
      "OtpMessage": {
        "properties": {
          "custom_text": {
            "description": "Custom text contained is the one-time password SMS sent to the Signer. This feature is available from SCALE plan, and disabled by default. Please contact [customer support](https://yousign.app/auth/workspace/help) to request an activation.",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "custom_text"
        ],
        "title": "OTP Message",
        "type": "object"
      },
      "UnauthorizedResponse": {
        "properties": {
          "type": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "detail",
          "type"
        ],
        "title": "UnauthorizedResponse",
        "type": "object"
      },
      "ForbiddenResponse": {
        "properties": {
          "type": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "detail",
          "type"
        ],
        "title": "ForbiddenResponse",
        "type": "object"
      },
      "NotFoundResponse": {
        "properties": {
          "type": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "detail",
          "type"
        ],
        "title": "NotFoundResponse",
        "type": "object"
      },
      "MethodNotAllowed": {
        "properties": {
          "message": {
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "title": "MethodNotAllowed",
        "type": "object"
      },
      "UnsupportedMediaTypeResponse": {
        "properties": {
          "type": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "detail",
          "type"
        ],
        "title": "UnsupportedMediaTypeResponse",
        "type": "object"
      },
      "TooManyRequestsResponse": {
        "properties": {
          "message": {
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "title": "TooManyRequestsResponse",
        "type": "object"
      },
      "InternalServerError": {
        "properties": {
          "type": {
            "example": "about:blank",
            "type": "string"
          },
          "detail": {
            "example": "Something wrong occurred.",
            "type": "string"
          }
        },
        "required": [
          "detail",
          "type"
        ],
        "title": "InternalServerError",
        "type": "object"
      },
      "CreateSignerBadRequestResponse": {
        "properties": {
          "type": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "detail",
          "type"
        ],
        "title": "CreateSignerBadRequestResponse",
        "type": "object"
      },
      "New_Approver_Group_identity_pool": {
        "properties": {
          "first_name": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "last_name": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "email": {
            "format": "email",
            "maxLength": 100,
            "minLength": 1,
            "type": "string"
          },
          "phone_number": {
            "description": "E.164 format.",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "locale": {
            "$ref": "#/components/schemas/Locale"
          }
        },
        "required": [
          "email",
          "first_name",
          "last_name",
          "locale"
        ],
        "type": "object"
      },
      "FieldRadioButtonGroup_radios_inner": {
        "properties": {
          "name": {
            "description": "Radio button's name.",
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "x": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "size": {
            "description": "The size determines both the width and height of the radio button.",
            "format": "int32",
            "maximum": 240,
            "minimum": 8,
            "type": "integer"
          },
          "checked": {
            "description": "Signer has checked the radio button.",
            "type": "boolean"
          }
        },
        "required": [
          "checked",
          "name",
          "size",
          "x",
          "y"
        ],
        "type": "object"
      },
      "Signer_info": {
        "description": "The Signer's identity. Always present for a single Signer. For a group (see `identity_pool`), `null` until one of its members has signed or declined, then that member.",
        "nullable": true,
        "properties": {
          "first_name": {
            "minLength": 1,
            "type": "string"
          },
          "last_name": {
            "minLength": 1,
            "type": "string"
          },
          "email": {
            "format": "email",
            "minLength": 1,
            "type": "string"
          },
          "phone_number": {
            "description": "E.164 format. Becomes mandatory if `signature_authentication_mode` requires a phone number.",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "locale": {
            "$ref": "#/components/schemas/Locale"
          }
        },
        "required": [
          "email",
          "first_name",
          "last_name",
          "locale",
          "phone_number"
        ],
        "type": "object"
      },
      "Signer_identity_pool_inner": {
        "properties": {
          "first_name": {
            "minLength": 1,
            "type": "string"
          },
          "last_name": {
            "minLength": 1,
            "type": "string"
          },
          "email": {
            "format": "email",
            "minLength": 1,
            "type": "string"
          },
          "phone_number": {
            "description": "E.164 format. Becomes mandatory if `signature_authentication_mode` requires a phone number.",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "locale": {
            "$ref": "#/components/schemas/Locale"
          },
          "signature_link": {
            "description": "The signature link for this member, when it is the group's turn to sign; `null` otherwise.",
            "format": "uri",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "email",
          "first_name",
          "last_name",
          "locale",
          "phone_number",
          "signature_link"
        ],
        "type": "object"
      },
      "Signer_fields_inner": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/FieldSignature"
          },
          {
            "$ref": "#/components/schemas/FieldText"
          },
          {
            "$ref": "#/components/schemas/FieldMention"
          },
          {
            "$ref": "#/components/schemas/FieldCheckbox"
          },
          {
            "$ref": "#/components/schemas/FieldRadioButtonGroup"
          }
        ]
      },
      "Signer_redirect_urls": {
        "description": "",
        "properties": {
          "success": {
            "example": "https://example.com/success",
            "format": "uri",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "error": {
            "example": "https://example.com/error",
            "format": "uri",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "decline": {
            "example": "https://example.com/decline",
            "format": "uri",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "decline",
          "error",
          "success"
        ],
        "type": "object"
      },
      "New_Signer_From_Scratch_info": {
        "properties": {
          "first_name": {
            "allOf": [
              {
                "$ref": "#/components/schemas/HumanName"
              }
            ],
            "example": "John",
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "last_name": {
            "allOf": [
              {
                "$ref": "#/components/schemas/HumanName"
              }
            ],
            "example": "Doe",
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "email": {
            "format": "email",
            "maxLength": 100,
            "minLength": 1,
            "type": "string"
          },
          "phone_number": {
            "description": "E.164 format. Becomes mandatory if `signature_authentication_mode` requires a phone number.",
            "example": "+41446667700",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "locale": {
            "$ref": "#/components/schemas/Locale"
          }
        },
        "required": [
          "email",
          "first_name",
          "last_name",
          "locale"
        ],
        "type": "object"
      },
      "New_Signer_From_Scratch_redirect_urls": {
        "properties": {
          "success": {
            "example": "https://example.com/success",
            "format": "uri",
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "error": {
            "example": "https://example.com/error",
            "format": "uri",
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "decline": {
            "example": "https://example.com/decline",
            "format": "uri",
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "New_Signer_From_Scratch_custom_text": {
        "properties": {
          "request_subject": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 512,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "request_body": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_subject": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 512,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_body": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "New_Signer_From_Scratch": {
        "description": "Create a new signer from scratch",
        "properties": {
          "info": {
            "$ref": "#/components/schemas/New_Signer_From_Scratch_info"
          },
          "fields": {
            "description": "Fields to assign to the Signer. Multiple Fields can be added simultaneously.",
            "items": {
              "$ref": "#/components/schemas/FieldsInput"
            },
            "type": "array"
          },
          "insert_after_id": {
            "description": "ID of the recipient this one must follow in an ordered flow; they will only be asked to act after that recipient.\nWhen `custom_recipient_order` is enabled, this can reference any approver or signer.\nWhen `custom_recipient_order` is disabled, the referenced ID must be a signer. `ordered_signers` must be enabled on the Signature Request.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "group_with_id": {
            "description": "ID of another recipient (Approver or Signer); both will be allowed to act in parallel in an ordered flow.\nOnly available when `custom_recipient_order` is enabled.\n\n`group_with_id` means parallel signing: both recipients must act, at the same time. It is unrelated to a\nSigner group (`identity_pool`), where any one member acts on behalf of the whole group.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "signature_level": {
            "enum": [
              "electronic_signature",
              "advanced_electronic_signature",
              "qualified_electronic_signature"
            ],
            "type": "string"
          },
          "signature_authentication_mode": {
            "description": "Method to authenticate the Signers. Authentication via SMS one-time password (otp_sms) is unavailable for phone numbers in China.",
            "enum": [
              "otp_email",
              "otp_sms",
              "no_otp"
            ],
            "nullable": true,
            "type": "string"
          },
          "redirect_urls": {
            "$ref": "#/components/schemas/New_Signer_From_Scratch_redirect_urls"
          },
          "custom_text": {
            "$ref": "#/components/schemas/New_Signer_From_Scratch_custom_text"
          },
          "delivery_mode": {
            "$ref": "#/components/schemas/SignerDeliveryMode"
          },
          "identification_attestation_id": {
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "sms_notification": {
            "$ref": "#/components/schemas/SmsNotification_1"
          },
          "email_notification": {
            "$ref": "#/components/schemas/EmailNotification_1"
          },
          "pre_identity_verification_required": {
            "description": "Defines the way the Signer's Identity Documents will be uploaded for Verification. If set to `true`, `signature_level`should be equal to `advanced_electronic_signature` and `delivery_mode` set to `none`.",
            "type": "boolean"
          },
          "excluded_documents": {
            "$ref": "#/components/schemas/ExcludedDocuments"
          },
          "disabled_signing_contexts": {
            "$ref": "#/components/schemas/DisabledSigningContexts"
          },
          "smart_anchor_identifier": {
            "$ref": "#/components/schemas/SignerSmartAnchorIdentifier"
          }
        },
        "required": [
          "info",
          "signature_level"
        ],
        "title": "New Signer From Scratch",
        "type": "object"
      },
      "New_Signer_From_Existing_User_custom_text": {
        "properties": {
          "request_subject": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 150,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "request_body": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_subject": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 150,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_body": {
            "description": "This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string) allowing email and leading or trailing whitespaces.",
            "format": "safe-string",
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "New_Signer_From_Existing_User": {
        "description": "Create a new signer from an existing user",
        "properties": {
          "user_id": {
            "description": "Create signer from an existing user",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "type": "string"
          },
          "fields": {
            "items": {
              "$ref": "#/components/schemas/FieldsInput"
            },
            "type": "array"
          },
          "insert_after_id": {
            "description": "ID of the recipient this one must follow in an ordered flow; they will only be asked to act after that recipient.\nWhen `custom_recipient_order` is enabled, this can reference any approver or signer.\nWhen `custom_recipient_order` is disabled, the referenced ID must be a signer. `ordered_signers` must be enabled on the Signature Request.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "group_with_id": {
            "description": "ID of another recipient (Approver or Signer); both will be allowed to act in parallel in an ordered flow.\nOnly available when `custom_recipient_order` is enabled.\n\n`group_with_id` means parallel signing: both recipients must act, at the same time. It is unrelated to a\nSigner group (`identity_pool`), where any one member acts on behalf of the whole group.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "signature_level": {
            "enum": [
              "electronic_signature",
              "advanced_electronic_signature",
              "qualified_electronic_signature"
            ],
            "type": "string"
          },
          "signature_authentication_mode": {
            "description": "Method to authenticate the Signers. Authentication via SMS one-time password (otp_sms) is unavailable for phone numbers in China.",
            "enum": [
              "otp_email",
              "otp_sms",
              "no_otp"
            ],
            "nullable": true,
            "type": "string"
          },
          "redirect_urls": {
            "$ref": "#/components/schemas/New_Signer_From_Scratch_redirect_urls"
          },
          "custom_text": {
            "$ref": "#/components/schemas/New_Signer_From_Existing_User_custom_text"
          },
          "delivery_mode": {
            "$ref": "#/components/schemas/SignerDeliveryMode"
          },
          "identification_attestation_id": {
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "sms_notification": {
            "$ref": "#/components/schemas/SmsNotification_1"
          },
          "email_notification": {
            "$ref": "#/components/schemas/EmailNotification_1"
          },
          "pre_identity_verification_required": {
            "description": "Defines the way the Signer's Identity Documents will be uploaded for Verification. If set to `true`, `signature_level`should be equal to `advanced_electronic_signature` and `delivery_mode` set to `none`.",
            "nullable": false,
            "type": "boolean"
          },
          "excluded_documents": {
            "$ref": "#/components/schemas/ExcludedDocuments"
          },
          "disabled_signing_contexts": {
            "$ref": "#/components/schemas/DisabledSigningContexts"
          },
          "smart_anchor_identifier": {
            "$ref": "#/components/schemas/SignerSmartAnchorIdentifier"
          }
        },
        "required": [
          "signature_level",
          "user_id"
        ],
        "title": "New Signer From Existing User",
        "type": "object"
      },
      "New_Signer_From_Existing_Contact": {
        "description": "Create a new signer from an existing contact",
        "properties": {
          "contact_id": {
            "description": "Create signer from an existing contact",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "type": "string"
          },
          "fields": {
            "items": {
              "$ref": "#/components/schemas/FieldsInput"
            },
            "type": "array"
          },
          "insert_after_id": {
            "description": "ID of the recipient this one must follow in an ordered flow; they will only be asked to act after that recipient.\nWhen `custom_recipient_order` is enabled, this can reference any approver or signer.\nWhen `custom_recipient_order` is disabled, the referenced ID must be a signer. `ordered_signers` must be enabled on the Signature Request.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "group_with_id": {
            "description": "ID of another recipient (Approver or Signer); both will be allowed to act in parallel in an ordered flow.\nOnly available when `custom_recipient_order` is enabled.\n\n`group_with_id` means parallel signing: both recipients must act, at the same time. It is unrelated to a\nSigner group (`identity_pool`), where any one member acts on behalf of the whole group.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "signature_level": {
            "enum": [
              "electronic_signature",
              "advanced_electronic_signature",
              "qualified_electronic_signature"
            ],
            "type": "string"
          },
          "signature_authentication_mode": {
            "description": "Method to authenticate the Signers. Authentication via SMS one-time password (otp_sms) is unavailable for phone numbers in China.",
            "enum": [
              "otp_email",
              "otp_sms",
              "no_otp"
            ],
            "nullable": true,
            "type": "string"
          },
          "redirect_urls": {
            "$ref": "#/components/schemas/New_Signer_From_Scratch_redirect_urls"
          },
          "custom_text": {
            "$ref": "#/components/schemas/New_Signer_From_Existing_User_custom_text"
          },
          "delivery_mode": {
            "$ref": "#/components/schemas/SignerDeliveryMode"
          },
          "identification_attestation_id": {
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "sms_notification": {
            "$ref": "#/components/schemas/SmsNotification_1"
          },
          "email_notification": {
            "$ref": "#/components/schemas/EmailNotification_1"
          },
          "pre_identity_verification_required": {
            "description": "Defines the way the Signer's Identity Documents will be uploaded for Verification. If set to `true`, `signature_level`should be equal to `advanced_electronic_signature` and `delivery_mode` set to `none`.",
            "nullable": false,
            "type": "boolean"
          },
          "excluded_documents": {
            "$ref": "#/components/schemas/ExcludedDocuments"
          },
          "disabled_signing_contexts": {
            "$ref": "#/components/schemas/DisabledSigningContexts"
          },
          "smart_anchor_identifier": {
            "$ref": "#/components/schemas/SignerSmartAnchorIdentifier"
          }
        },
        "required": [
          "contact_id",
          "signature_level"
        ],
        "title": "New Signer From Existing Contact",
        "type": "object"
      },
      "New_Signer_From_Identity_Verification_info": {
        "properties": {
          "email": {
            "format": "email",
            "maxLength": 100,
            "minLength": 1,
            "type": "string"
          },
          "phone_number": {
            "description": "E.164 format. Becomes mandatory if `signature_authentication_mode` requires a phone number.",
            "example": "+41446667700",
            "minLength": 1,
            "type": "string"
          },
          "locale": {
            "$ref": "#/components/schemas/Locale"
          }
        },
        "required": [
          "email",
          "locale",
          "phone_number"
        ],
        "type": "object"
      },
      "New_Signer_From_Identity_Verification_custom_text": {
        "properties": {
          "request_subject": {
            "maxLength": 512,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "request_body": {
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_subject": {
            "maxLength": 512,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "reminder_body": {
            "maxLength": 2000,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "New_Signer_From_Identity_Verification": {
        "description": "Create a new signer from an identity verification",
        "properties": {
          "verified_identity_id": {
            "description": "Create a signer from an identity verification. The signature level must be set to `advanced_electronic_signature`.",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "type": "string"
          },
          "info": {
            "$ref": "#/components/schemas/New_Signer_From_Identity_Verification_info"
          },
          "fields": {
            "description": "Fields to assign to the Signer. Multiple Fields can be added simultaneously.",
            "items": {
              "$ref": "#/components/schemas/FieldsInput"
            },
            "type": "array"
          },
          "insert_after_id": {
            "description": "ID of the recipient this one must follow in an ordered flow; they will only be asked to act after that recipient.\nWhen `custom_recipient_order` is enabled, this can reference any approver or signer.\nWhen `custom_recipient_order` is disabled, the referenced ID must be a signer. `ordered_signers` must be enabled on the Signature Request.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "group_with_id": {
            "description": "ID of another recipient (Approver or Signer); both will be allowed to act in parallel in an ordered flow.\nOnly available when `custom_recipient_order` is enabled.\n\n`group_with_id` means parallel signing: both recipients must act, at the same time. It is unrelated to a\nSigner group (`identity_pool`), where any one member acts on behalf of the whole group.\n",
            "example": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "signature_level": {
            "enum": [
              "advanced_electronic_signature"
            ],
            "type": "string"
          },
          "signature_authentication_mode": {
            "description": "Method to authenticate the Signers. Authentication via SMS one-time password (otp_sms) is unavailable for phone numbers in China.",
            "enum": [
              "otp_sms"
            ],
            "type": "string"
          },
          "redirect_urls": {
            "$ref": "#/components/schemas/New_Signer_From_Scratch_redirect_urls"
          },
          "custom_text": {
            "$ref": "#/components/schemas/New_Signer_From_Identity_Verification_custom_text"
          },
          "delivery_mode": {
            "$ref": "#/components/schemas/SignerDeliveryMode"
          },
          "sms_notification": {
            "$ref": "#/components/schemas/SmsNotification_1"
          },
          "email_notification": {
            "$ref": "#/components/schemas/EmailNotification_1"
          },
          "excluded_documents": {
            "$ref": "#/components/schemas/ExcludedDocuments"
          },
          "disabled_signing_contexts": {
            "$ref": "#/components/schemas/DisabledSigningContexts"
          },
          "smart_anchor_identifier": {
            "$ref": "#/components/schemas/SignerSmartAnchorIdentifier"
          }
        },
        "required": [
          "info",
          "signature_authentication_mode",
          "signature_level",
          "verified_identity_id"
        ],
        "title": "New Signer From Identity Verification",
        "type": "object"
      },
      "New_Signer_Group_redirect_urls": {
        "description": "Applies to every member of the group.",
        "properties": {
          "success": {
            "format": "uri",
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "error": {
            "format": "uri",
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "decline": {
            "format": "uri",
            "maxLength": 255,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "New_Signer_Group": {
        "description": "Create a new Signer group from a list of members.\n\nNot supported together with `identity_pool`: `identification_attestation_id` and\n`pre_identity_verification_required` (rejected with `signer.identity_pool_excludes_attribute`), and\n`verified_identity_id` (rejected with a `400` error).\nA group only supports the simple electronic signature level.\n\n`custom_text` and `email_notification` are shared by the whole group. They are stored but not yet applied to the\nemails sent to its members.\n",
        "properties": {
          "identity_pool": {
            "description": "The members of the group, at least two, who can sign on behalf of the group.",
            "items": {
              "$ref": "#/components/schemas/New_Approver_Group_identity_pool"
            },
            "minItems": 2,
            "type": "array"
          },
          "fields": {
            "description": "Fields to assign to the Signer group. They are shared by every member of the group.",
            "items": {
              "$ref": "#/components/schemas/FieldsInput"
            },
            "type": "array"
          },
          "signature_level": {
            "enum": [
              "electronic_signature"
            ],
            "type": "string"
          },
          "signature_authentication_mode": {
            "enum": [
              "otp_email",
              "otp_sms",
              "no_otp"
            ],
            "nullable": true,
            "type": "string"
          },
          "delivery_mode": {
            "$ref": "#/components/schemas/SignerDeliveryMode"
          },
          "custom_text": {
            "$ref": "#/components/schemas/CustomText"
          },
          "redirect_urls": {
            "$ref": "#/components/schemas/New_Signer_Group_redirect_urls"
          },
          "sms_notification": {
            "$ref": "#/components/schemas/SmsNotification_1"
          },
          "email_notification": {
            "$ref": "#/components/schemas/EmailNotification_1"
          },
          "insert_after_id": {
            "description": "ID of the recipient this group must follow in an ordered flow. When `custom_recipient_order` is enabled, this can reference any recipient; otherwise, a signer or a Signer group.",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "group_with_id": {
            "description": "ID of another recipient (Approver, Signer or Signer group); both are allowed to act in parallel. Only available when `custom_recipient_order` is enabled. Unrelated to the Signer group itself: this only makes the group act in parallel with another recipient.",
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "disabled_signing_contexts": {
            "$ref": "#/components/schemas/DisabledSigningContexts"
          },
          "excluded_documents": {
            "$ref": "#/components/schemas/ExcludedDocuments"
          }
        },
        "required": [
          "identity_pool",
          "signature_level"
        ],
        "title": "New Signer Group",
        "type": "object"
      },
      "SignatureDisplay_oneOf": {
        "properties": {
          "layout": {
            "description": "• `minimal` (default): Only shows the signer’s signature visual.\n• `detailed`: Adds extra detail to the signature field, including the signer’s full name, email, and the date of signature.\n",
            "enum": [
              "minimal",
              "legacy"
            ],
            "type": "string"
          }
        },
        "required": [
          "layout"
        ],
        "type": "object"
      },
      "SignatureDisplay_oneOf_1_options": {
        "description": "Only applicable when `display.layout = detailed`.",
        "properties": {
          "date_format": {
            "$ref": "#/components/schemas/CreateFieldDateFormat"
          },
          "time_format": {
            "$ref": "#/components/schemas/CreateFieldTimeFormat"
          },
          "show_timezone": {
            "default": false,
            "description": "Boolean indicating whether to display the timezone abbreviation (e.g., `CEST`) next to the time.",
            "nullable": true,
            "type": "boolean"
          },
          "show_email": {
            "default": true,
            "description": "Boolean indicating whether to display the signer's email address.",
            "nullable": false,
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "SignatureDisplay_oneOf_1": {
        "properties": {
          "layout": {
            "description": "• `minimal` (default): Only shows the signer’s signature visual.\n• `detailed`: Adds extra detail to the signature field, including the signer’s full name, email, and the date of signature.\n",
            "enum": [
              "detailed"
            ],
            "type": "string"
          },
          "options": {
            "$ref": "#/components/schemas/SignatureDisplay_oneOf_1_options"
          }
        },
        "required": [
          "layout",
          "options"
        ],
        "type": "object"
      },
      "Minimal_layout": {
        "properties": {
          "layout": {
            "description": "`minimal` (default): Only shows the signer’s signature visual.\n`detailed`: Adds extra detail to the signature field, including the signer’s full name, email, and the date of signature.\n",
            "enum": [
              "minimal"
            ],
            "type": "string"
          }
        },
        "required": [
          "layout"
        ],
        "title": "Minimal layout",
        "type": "object"
      },
      "Detailed_layout": {
        "example": {
          "layout": "detailed",
          "options": {
            "date_format": "dd/MM/yyyy",
            "time_format": "HH:mm",
            "show_timezone": true,
            "show_email": false
          }
        },
        "properties": {
          "layout": {
            "description": "`minimal` (default): Only shows the signer’s signature visual.\n`detailed`: Adds extra detail to the signature field, including the signer’s full name, email, and the date of signature.\n",
            "enum": [
              "detailed"
            ],
            "type": "string"
          },
          "options": {
            "$ref": "#/components/schemas/SignatureDisplay_oneOf_1_options"
          }
        },
        "required": [
          "layout",
          "options"
        ],
        "title": "Detailed layout",
        "type": "object"
      },
      "Signature_2": {
        "properties": {
          "document_id": {
            "description": "Identifier of the Document the signature Field is placed on.",
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "description": "Field type discriminator.",
            "enum": [
              "signature"
            ],
            "type": "string"
          },
          "page": {
            "description": "Page number where the Field is placed.",
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "description": "Horizontal position (points from left).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "description": "Vertical position (points from top).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "height": {
            "description": "Height of the signature Field in points (default 37).",
            "format": "int32",
            "maximum": 1000,
            "minimum": 37,
            "type": "integer"
          },
          "width": {
            "description": "Width of the signature Field in points (default 85).",
            "format": "int32",
            "maximum": 2000,
            "minimum": 85,
            "type": "integer"
          },
          "reason": {
            "allOf": [
              {
                "$ref": "#/components/schemas/HumanName"
              }
            ],
            "description": "Provide extra context to explain why the Document is being signed. Once the Document is signed, the custom reason is stored in the Audit Trail and is included in the signature certificate.\nThe default value is: \"Signed by [Signer first name] [Signer last name]\".\n",
            "example": "Signed by John Doe",
            "maxLength": 150,
            "nullable": true,
            "type": "string"
          },
          "display": {
            "$ref": "#/components/schemas/SignatureDisplay_1"
          }
        },
        "required": [
          "document_id",
          "page",
          "type",
          "x",
          "y"
        ],
        "title": "Signature",
        "type": "object"
      },
      "Mention_2": {
        "properties": {
          "document_id": {
            "description": "Identifier of the Document the mention Field is placed on.",
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "description": "Field type discriminator.",
            "enum": [
              "mention"
            ],
            "type": "string"
          },
          "page": {
            "description": "Page number where the Field is placed.",
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "description": "Horizontal position (points from left).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "description": "Vertical position (points from top).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "width": {
            "description": "If not set, the width is automatically calculated with the mention length",
            "format": "int32",
            "minimum": 24,
            "type": "integer"
          },
          "height": {
            "description": "The height must be 24 or a multiple of 15 greater than 24. If height is not provided, it will be calculated depending on the number of newlines in the mention",
            "example": 150,
            "format": "int32",
            "minimum": 24,
            "nullable": true,
            "type": "integer"
          },
          "mention": {
            "description": "Text of the mention displayed on the Document.",
            "format": "safe-string",
            "type": "string"
          },
          "name": {
            "description": "Name of the Field.",
            "example": "Job Title",
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "document_id",
          "mention",
          "page",
          "type",
          "x",
          "y"
        ],
        "title": "Mention",
        "type": "object"
      },
      "Text_2": {
        "properties": {
          "document_id": {
            "description": "Identifier of the Document the text Field is placed on.",
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "description": "Field type discriminator.",
            "enum": [
              "text"
            ],
            "type": "string"
          },
          "page": {
            "description": "Page number where the Field is placed.",
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "description": "Horizontal position (points from left).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "description": "Vertical position (points from top).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "width": {
            "description": "If not set, the width is automatically calculated with the max_length value",
            "example": 90,
            "format": "int32",
            "minimum": 24,
            "type": "integer"
          },
          "height": {
            "description": "The height must be 24 or a multiple of 15 greater than 24.",
            "example": 150,
            "format": "int32",
            "minimum": 24,
            "type": "integer"
          },
          "max_length": {
            "description": "Maximum number of characters the Signer can enter.",
            "maximum": 32767,
            "minimum": 1,
            "type": "integer"
          },
          "question": {
            "description": "Question/label shown to the Signer for this text Field.",
            "example": "What is your job title?",
            "maxLength": 255,
            "type": "string"
          },
          "instruction": {
            "description": "Additional instruction shown to the Signer.",
            "example": "Your position in the company",
            "nullable": true,
            "type": "string"
          },
          "optional": {
            "description": "Whether filling this Field is optional.",
            "type": "boolean"
          },
          "name": {
            "description": "Name of the Field.",
            "example": "Job Title",
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "default_value": {
            "description": "If a default value is provided, the Field will be pre-filled with this value. The Signer can modify it before signing unless the Field is set to `read-only`.",
            "example": "Software Engineer",
            "maxLength": 32767,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "read_only": {
            "default": false,
            "description": "If set to `true`, the Signer cannot modify the Field and the default value (if provided) will remain unchanged.",
            "type": "boolean"
          }
        },
        "required": [
          "document_id",
          "max_length",
          "optional",
          "page",
          "question",
          "type",
          "x",
          "y"
        ],
        "title": "Text",
        "type": "object"
      },
      "Checkbox_2": {
        "properties": {
          "document_id": {
            "description": "Identifier of the Document the checkbox Field is placed on.",
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "description": "Field type discriminator.",
            "enum": [
              "checkbox"
            ],
            "type": "string"
          },
          "page": {
            "description": "Page number where the Field is placed.",
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "description": "Horizontal position (points from left).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "description": "Vertical position (points from top).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "size": {
            "description": "The omission of size parameter is considered as deprecated. The size determines both the width and height of the checkbox.",
            "format": "int32",
            "maximum": 240,
            "minimum": 8,
            "type": "integer"
          },
          "optional": {
            "description": "Whether ticking this checkbox is optional.",
            "type": "boolean"
          },
          "name": {
            "description": "Name of the checkbox Field.",
            "example": "Checkbox 1",
            "nullable": true,
            "type": "string"
          },
          "checked": {
            "description": "Current checked state of the checkbox.",
            "type": "boolean"
          },
          "default_checked": {
            "description": "Whether the checkbox is initially checked.",
            "type": "boolean"
          },
          "read_only": {
            "default": false,
            "description": "If set to `true`, the checkbox cannot be modified by the signer.",
            "type": "boolean"
          }
        },
        "required": [
          "checked",
          "document_id",
          "optional",
          "page",
          "type",
          "x",
          "y"
        ],
        "title": "Checkbox",
        "type": "object"
      },
      "RadioGroup_2_radios_inner": {
        "properties": {
          "name": {
            "description": "Radio button's name",
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "x": {
            "description": "Horizontal position of the radio (points from left).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "description": "Vertical position of the radio (points from top).",
            "format": "int32",
            "maximum": 32767,
            "minimum": 0,
            "type": "integer"
          },
          "size": {
            "description": "Size (width and height) of the radio in points.",
            "format": "int32",
            "maximum": 240,
            "minimum": 8,
            "type": "integer"
          },
          "default_checked": {
            "default": false,
            "description": "Indicates whether the radio is initially checked (`true`) or unchecked (`false`).",
            "type": "boolean"
          }
        },
        "required": [
          "x",
          "y"
        ],
        "type": "object"
      },
      "RadioGroup_2": {
        "properties": {
          "document_id": {
            "description": "Identifier of the Document the radio group Field is placed on.",
            "example": "9b6ed2f3-244f-487a-baa1-bbe4f51c8748",
            "format": "uuid",
            "type": "string"
          },
          "type": {
            "description": "Field type discriminator.",
            "enum": [
              "radio_group"
            ],
            "type": "string"
          },
          "page": {
            "description": "Page number where the Field is placed.",
            "format": "int32",
            "minimum": 1,
            "type": "integer"
          },
          "optional": {
            "description": "Whether selecting a radio is optional.",
            "type": "boolean"
          },
          "name": {
            "description": "Radio group's name",
            "example": "radio_group_name_1",
            "maxLength": 128,
            "minLength": 1,
            "nullable": true,
            "type": "string"
          },
          "read_only": {
            "default": false,
            "description": "If set to `true`, the radio button cannot be modified by the Signer.",
            "type": "boolean"
          },
          "radios": {
            "description": "List of radio buttons in the group.",
            "items": {
              "$ref": "#/components/schemas/RadioGroup_2_radios_inner"
            },
            "type": "array"
          }
        },
        "required": [
          "document_id",
          "optional",
          "page",
          "radios",
          "type"
        ],
        "title": "RadioGroup",
        "type": "object"
      },
      "OTP_Message": {
        "properties": {
          "custom_text": {
            "description": "Custom text contained is the one-time password SMS sent to the Signer. This feature is available from SCALE plan, and disabled by default. Please contact [customer support](https://yousign.app/auth/workspace/help) to request an activation. This value is a string composed of GSM characters supported by 7-bit encoding, must contain \"{code}\", the length must be less than 105 and cannot contain URL, email, phone number and IP address.\\\nThis property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string).\n",
            "format": "safe-string",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "custom_text"
        ],
        "title": "OTP Message",
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}
```