{"openapi":"3.0.2","paths":{"/api/v1/documents":{"get":{"summary":"Get all documents","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"default":1,"type":"number","minimum":1}},{"name":"perPage","in":"query","schema":{"default":10,"type":"number","minimum":1}},{"name":"folderId","in":"query","description":"Filter documents by folder ID. When omitted, returns root documents.","schema":{"type":"string"}}],"operationId":"getDocuments","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"documents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt"]}},"totalPages":{"type":"number"}},"required":["documents","totalPages"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"post":{"summary":"Upload a new document and get a presigned URL","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createDocument","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"externalId":{"type":"string","nullable":true},"folderId":{"type":"string","description":"The ID of the folder to create the document in. If not provided, the document will be created in the root folder."},"recipients":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"idDocumentCountry":{"type":"string","minLength":2,"maxLength":2,"description":"País del documento (ISO-3166 de 2 letras). Por defecto `AR`."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"Número del documento de identidad contra el que se valida la verificación biométrica (si `meta.requireBiometricId` está activo). El documento que presente el firmante tiene que coincidir. Si no lo mandás, el firmante lo carga antes de verificarse."},"idDocumentType":{"type":"string","maxLength":32,"description":"Tipo de documento para la verificación biométrica. Por defecto, DNI."},"firstName":{"type":"string","maxLength":255,"description":"Nombre(s) del firmante, por separado del apellido — así lo valida el proveedor biométrico. Recomendado si activás `meta.requireBiometricId`."},"lastName":{"type":"string","maxLength":255,"description":"Apellido(s) del firmante, por separado del nombre. Recomendado si activás `meta.requireBiometricId`."}},"required":["name","email"]}},"meta":{"default":{},"type":"object","properties":{"subject":{"type":"string"},"message":{"type":"string"},"timezone":{"default":"Etc/UTC","type":"string","description":"The timezone of the date. Must be one of the options listed in the list below.","enum":["Etc/UTC","Africa/Abidjan","Africa/Accra","Africa/Addis_Ababa","Africa/Algiers","Africa/Asmara","Africa/Bamako","Africa/Bangui","Africa/Banjul","Africa/Bissau","Africa/Blantyre","Africa/Brazzaville","Africa/Bujumbura","Africa/Cairo","Africa/Casablanca","Africa/Ceuta","Africa/Conakry","Africa/Dakar","Africa/Dar_es_Salaam","Africa/Djibouti","Africa/Douala","Africa/El_Aaiun","Africa/Freetown","Africa/Gaborone","Africa/Harare","Africa/Johannesburg","Africa/Juba","Africa/Kampala","Africa/Khartoum","Africa/Kigali","Africa/Kinshasa","Africa/Lagos","Africa/Libreville","Africa/Lome","Africa/Luanda","Africa/Lubumbashi","Africa/Lusaka","Africa/Malabo","Africa/Maputo","Africa/Maseru","Africa/Mbabane","Africa/Mogadishu","Africa/Monrovia","Africa/Nairobi","Africa/Ndjamena","Africa/Niamey","Africa/Nouakchott","Africa/Ouagadougou","Africa/Porto-Novo","Africa/Sao_Tome","Africa/Tripoli","Africa/Tunis","Africa/Windhoek","America/Adak","America/Anchorage","America/Anguilla","America/Antigua","America/Araguaina","America/Argentina/Buenos_Aires","America/Argentina/Catamarca","America/Argentina/Cordoba","America/Argentina/Jujuy","America/Argentina/La_Rioja","America/Argentina/Mendoza","America/Argentina/Rio_Gallegos","America/Argentina/Salta","America/Argentina/San_Juan","America/Argentina/San_Luis","America/Argentina/Tucuman","America/Argentina/Ushuaia","America/Aruba","America/Asuncion","America/Atikokan","America/Bahia","America/Bahia_Banderas","America/Barbados","America/Belem","America/Belize","America/Blanc-Sablon","America/Boa_Vista","America/Bogota","America/Boise","America/Cambridge_Bay","America/Campo_Grande","America/Cancun","America/Caracas","America/Cayenne","America/Cayman","America/Chicago","America/Chihuahua","America/Ciudad_Juarez","America/Costa_Rica","America/Coyhaique","America/Creston","America/Cuiaba","America/Curacao","America/Danmarkshavn","America/Dawson","America/Dawson_Creek","America/Denver","America/Detroit","America/Dominica","America/Edmonton","America/Eirunepe","America/El_Salvador","America/Fort_Nelson","America/Fortaleza","America/Glace_Bay","America/Goose_Bay","America/Grand_Turk","America/Grenada","America/Guadeloupe","America/Guatemala","America/Guayaquil","America/Guyana","America/Halifax","America/Havana","America/Hermosillo","America/Indiana/Indianapolis","America/Indiana/Knox","America/Indiana/Marengo","America/Indiana/Petersburg","America/Indiana/Tell_City","America/Indiana/Vevay","America/Indiana/Vincennes","America/Indiana/Winamac","America/Inuvik","America/Iqaluit","America/Jamaica","America/Juneau","America/Kentucky/Louisville","America/Kentucky/Monticello","America/Kralendijk","America/La_Paz","America/Lima","America/Los_Angeles","America/Lower_Princes","America/Maceio","America/Managua","America/Manaus","America/Marigot","America/Martinique","America/Matamoros","America/Mazatlan","America/Menominee","America/Merida","America/Metlakatla","America/Mexico_City","America/Miquelon","America/Moncton","America/Monterrey","America/Montevideo","America/Montserrat","America/Nassau","America/New_York","America/Nome","America/Noronha","America/North_Dakota/Beulah","America/North_Dakota/Center","America/North_Dakota/New_Salem","America/Nuuk","America/Ojinaga","America/Panama","America/Paramaribo","America/Phoenix","America/Port-au-Prince","America/Port_of_Spain","America/Porto_Velho","America/Puerto_Rico","America/Punta_Arenas","America/Rankin_Inlet","America/Recife","America/Regina","America/Resolute","America/Rio_Branco","America/Santarem","America/Santiago","America/Santo_Domingo","America/Sao_Paulo","America/Scoresbysund","America/Sitka","America/St_Barthelemy","America/St_Johns","America/St_Kitts","America/St_Lucia","America/St_Thomas","America/St_Vincent","America/Swift_Current","America/Tegucigalpa","America/Thule","America/Tijuana","America/Toronto","America/Tortola","America/Vancouver","America/Whitehorse","America/Winnipeg","America/Yakutat","Antarctica/Casey","Antarctica/Davis","Antarctica/DumontDUrville","Antarctica/Macquarie","Antarctica/Mawson","Antarctica/McMurdo","Antarctica/Palmer","Antarctica/Rothera","Antarctica/Syowa","Antarctica/Troll","Antarctica/Vostok","Arctic/Longyearbyen","Asia/Aden","Asia/Almaty","Asia/Amman","Asia/Anadyr","Asia/Aqtau","Asia/Aqtobe","Asia/Ashgabat","Asia/Atyrau","Asia/Baghdad","Asia/Bahrain","Asia/Baku","Asia/Bangkok","Asia/Barnaul","Asia/Beirut","Asia/Bishkek","Asia/Brunei","Asia/Chita","Asia/Colombo","Asia/Damascus","Asia/Dhaka","Asia/Dili","Asia/Dubai","Asia/Dushanbe","Asia/Famagusta","Asia/Gaza","Asia/Hebron","Asia/Ho_Chi_Minh","Asia/Hong_Kong","Asia/Hovd","Asia/Irkutsk","Asia/Jakarta","Asia/Jayapura","Asia/Jerusalem","Asia/Kabul","Asia/Kamchatka","Asia/Karachi","Asia/Kathmandu","Asia/Khandyga","Asia/Kolkata","Asia/Krasnoyarsk","Asia/Kuala_Lumpur","Asia/Kuching","Asia/Kuwait","Asia/Macau","Asia/Magadan","Asia/Makassar","Asia/Manila","Asia/Muscat","Asia/Nicosia","Asia/Novokuznetsk","Asia/Novosibirsk","Asia/Omsk","Asia/Oral","Asia/Phnom_Penh","Asia/Pontianak","Asia/Pyongyang","Asia/Qatar","Asia/Qostanay","Asia/Qyzylorda","Asia/Riyadh","Asia/Sakhalin","Asia/Samarkand","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Srednekolymsk","Asia/Taipei","Asia/Tashkent","Asia/Tbilisi","Asia/Tehran","Asia/Thimphu","Asia/Tokyo","Asia/Tomsk","Asia/Ulaanbaatar","Asia/Urumqi","Asia/Ust-Nera","Asia/Vientiane","Asia/Vladivostok","Asia/Yakutsk","Asia/Yangon","Asia/Yekaterinburg","Asia/Yerevan","Atlantic/Azores","Atlantic/Bermuda","Atlantic/Canary","Atlantic/Cape_Verde","Atlantic/Faroe","Atlantic/Madeira","Atlantic/Reykjavik","Atlantic/South_Georgia","Atlantic/St_Helena","Atlantic/Stanley","Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Eucla","Australia/Hobart","Australia/Lindeman","Australia/Lord_Howe","Australia/Melbourne","Australia/Perth","Australia/Sydney","Europe/Amsterdam","Europe/Andorra","Europe/Astrakhan","Europe/Athens","Europe/Belgrade","Europe/Berlin","Europe/Bratislava","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Busingen","Europe/Chisinau","Europe/Copenhagen","Europe/Dublin","Europe/Gibraltar","Europe/Guernsey","Europe/Helsinki","Europe/Isle_of_Man","Europe/Istanbul","Europe/Jersey","Europe/Kaliningrad","Europe/Kirov","Europe/Kyiv","Europe/Lisbon","Europe/Ljubljana","Europe/London","Europe/Luxembourg","Europe/Madrid","Europe/Malta","Europe/Mariehamn","Europe/Minsk","Europe/Monaco","Europe/Moscow","Europe/Oslo","Europe/Paris","Europe/Podgorica","Europe/Prague","Europe/Riga","Europe/Rome","Europe/Samara","Europe/San_Marino","Europe/Sarajevo","Europe/Saratov","Europe/Simferopol","Europe/Skopje","Europe/Sofia","Europe/Stockholm","Europe/Tallinn","Europe/Tirane","Europe/Ulyanovsk","Europe/Vaduz","Europe/Vatican","Europe/Vienna","Europe/Vilnius","Europe/Volgograd","Europe/Warsaw","Europe/Zagreb","Europe/Zurich","Indian/Antananarivo","Indian/Chagos","Indian/Christmas","Indian/Cocos","Indian/Comoro","Indian/Kerguelen","Indian/Mahe","Indian/Maldives","Indian/Mauritius","Indian/Mayotte","Indian/Reunion","Pacific/Apia","Pacific/Auckland","Pacific/Bougainville","Pacific/Chatham","Pacific/Chuuk","Pacific/Easter","Pacific/Efate","Pacific/Fakaofo","Pacific/Fiji","Pacific/Funafuti","Pacific/Galapagos","Pacific/Gambier","Pacific/Guadalcanal","Pacific/Guam","Pacific/Honolulu","Pacific/Kanton","Pacific/Kiritimati","Pacific/Kosrae","Pacific/Kwajalein","Pacific/Majuro","Pacific/Marquesas","Pacific/Midway","Pacific/Nauru","Pacific/Niue","Pacific/Norfolk","Pacific/Noumea","Pacific/Pago_Pago","Pacific/Palau","Pacific/Pitcairn","Pacific/Pohnpei","Pacific/Port_Moresby","Pacific/Rarotonga","Pacific/Saipan","Pacific/Tahiti","Pacific/Tarawa","Pacific/Tongatapu","Pacific/Wake","Pacific/Wallis"]},"dateFormat":{"default":"yyyy-MM-dd hh:mm a","type":"string","description":"The format of the date. Must be one of the options listed in the list below.","enum":["yyyy-MM-dd hh:mm a","yyyy-MM-dd HH:mm","dd/MM/yyyy HH:mm","dd/MM/yyyy hh:mm a","dd-MM-yyyy HH:mm","dd-MM-yyyy hh:mm a","MM/dd/yyyy HH:mm","MM/dd/yyyy hh:mm a","dd.MM.yyyy HH:mm","yy-MM-dd HH:mm","yy-MM-dd hh:mm a","yyyy-MM-dd HH:mm:ss","MMMM dd, yyyy HH:mm","MMMM dd, yyyy hh:mm a","EEEE, MMMM dd, yyyy HH:mm","EEEE, MMMM dd, yyyy hh:mm a","yyyy-MM-dd'T'HH:mm:ss.SSSXXX","yyyy-MM-dd","dd/MM/yyyy","dd-MM-yyyy","MM/dd/yyyy","dd.MM.yyyy","yy-MM-dd","MMMM dd, yyyy","EEEE, MMMM dd, yyyy"]},"redirectUrl":{"type":"string"},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"]},"typedSignatureEnabled":{"default":true,"type":"boolean"},"uploadSignatureEnabled":{"default":true,"type":"boolean"},"drawSignatureEnabled":{"default":true,"type":"boolean"},"requireBiometricId":{"default":false,"type":"boolean","description":"Activa la verificación biométrica de identidad (DNI + prueba de vida facial) para este documento: cada firmante debe aprobarla antes de poder firmar. Mandá `meta: { \"requireBiometricId\": true }`; también se hereda de la plantilla si la dejaste activada en la interfaz. Cada verificación aprobada consume 1 crédito del pool prepago de la cuenta (separado del de documentos); sin créditos, el firmante firma normalmente en lugar de quedar bloqueado. El resto del circuito (signingUrl, webhooks, descarga) no cambia — ver \"Verificación biométrica\" al principio de esta página."},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"]},"emailSettings":{"nullable":true}}},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}}]},"globalActionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}]}},"description":"The globalActionAuth property is only available for Enterprise accounts."},"formValues":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"boolean"},{"type":"number"}]}},"attachments":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"data":{"type":"string","format":"uri"},"type":{"default":"link","type":"string","enum":["link"]}},"required":["label","data"]}}},"required":["title","recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"uploadUrl":{"type":"string","minLength":1},"documentId":{"type":"number"},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"name":{"type":"string"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","nullable":true},"token":{"type":"string"},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"signingUrl":{"type":"string"}},"required":["recipientId","name","email","token","role","signingUrl"]}}},"required":["uploadUrl","documentId","recipients"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}":{"get":{"summary":"Get a single document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getDocument","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"recipients":{},"fields":{}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt","recipients","fields"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"delete":{"summary":"Delete a document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteDocument","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/download":{"get":{"summary":"Download a signed document when the storage transport is S3","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"downloadOriginalDocument","in":"query","schema":{"default":false,"type":"boolean","nullable":true}}],"operationId":"downloadSignedDocument","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"downloadUrl":{"type":"string"}},"required":["downloadUrl"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/templates":{"post":{"summary":"Create a new template and get a presigned URL","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createTemplate","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":255,"description":"The title of the document."},"folderId":{"type":"string"},"externalId":{"type":"string","nullable":true},"visibility":{"type":"string","enum":["EVERYONE","MANAGER_AND_ABOVE","ADMIN"]},"globalAccessAuth":{"default":[],"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"globalActionAuth":{"default":[],"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}},"publicTitle":{"type":"string","minLength":1,"maxLength":50,"description":"The title of the template that will be displayed to the public. Only applicable for public templates."},"publicDescription":{"type":"string","minLength":1,"maxLength":256,"description":"The description of the template that will be displayed to the public. Only applicable for public templates."},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"meta":{"type":"object","properties":{"subject":{"type":"string","maxLength":254,"description":"The subject of the email that will be sent to the recipients."},"message":{"type":"string","maxLength":5000,"description":"The message of the email that will be sent to the recipients."},"timezone":{"type":"string","description":"The timezone to use for date fields and signing the document. Example Etc/UTC, Australia/Melbourne"},"dateFormat":{"type":"string","enum":["yyyy-MM-dd hh:mm a","yyyy-MM-dd","dd/MM/yyyy","dd-MM-yyyy","MM/dd/yyyy","yy-MM-dd","MMMM dd, yyyy","EEEE, MMMM dd, yyyy","dd/MM/yyyy hh:mm a","dd/MM/yyyy HH:mm","dd-MM-yyyy hh:mm a","dd-MM-yyyy HH:mm","MM/dd/yyyy hh:mm a","MM/dd/yyyy HH:mm","dd.MM.yyyy","dd.MM.yyyy HH:mm","yyyy-MM-dd HH:mm","yy-MM-dd hh:mm a","yy-MM-dd HH:mm","yyyy-MM-dd HH:mm:ss","MMMM dd, yyyy hh:mm a","MMMM dd, yyyy HH:mm","EEEE, MMMM dd, yyyy hh:mm a","EEEE, MMMM dd, yyyy HH:mm","yyyy-MM-dd'T'HH:mm:ss.SSSXXX"],"description":"The date format to use for date fields and signing the document."},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"],"description":"The distribution method to use when sending the document to the recipients."},"emailId":{"type":"string","nullable":true},"emailReplyTo":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","nullable":true},"emailSettings":{"nullable":true},"redirectUrl":{"type":"string","description":"The URL to which the recipient should be redirected after signing the document."},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"],"description":"The language to use for email communications with recipients."},"typedSignatureEnabled":{"type":"boolean","description":"Whether to allow recipients to sign using a typed signature."},"uploadSignatureEnabled":{"type":"boolean","description":"Whether to allow recipients to sign using an uploaded signature."},"drawSignatureEnabled":{"type":"boolean","description":"Whether to allow recipients to sign using a draw signature."},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"}}},"attachments":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"data":{"type":"string","format":"uri"},"type":{"default":"link","type":"string","enum":["link"]}},"required":["label","data"]}}},"required":["title"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"template":{"type":"object","properties":{"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"visibility":{"type":"string","enum":["EVERYONE","MANAGER_AND_ABOVE","ADMIN"]},"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number"},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"globalActionAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}},"required":["globalAccessAuth","globalActionAuth"],"nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":true},"publicTitle":{"type":"string"},"publicDescription":{"type":"string"},"folderId":{"type":"string","nullable":true},"envelopeId":{"type":"string"},"templateDocumentDataId":{"default":"","type":"string"},"templateDocumentData":{"type":"object","properties":{"type":{"type":"string","enum":["S3_PATH","BYTES","BYTES_64"]},"id":{"type":"string"},"data":{"type":"string"},"initialData":{"type":"string"},"envelopeItemId":{"type":"string"}},"required":["type","id","data","initialData","envelopeItemId"]},"templateMeta":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string","nullable":true},"message":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"dateFormat":{"type":"string","nullable":true},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"typedSignatureEnabled":{"type":"boolean"},"uploadSignatureEnabled":{"type":"boolean"},"drawSignatureEnabled":{"type":"boolean"},"allowDictateNextSigner":{"type":"boolean"},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"]},"redirectUrl":{"type":"string","nullable":true},"language":{"type":"string"},"emailSettings":{"nullable":true},"emailId":{"type":"string","nullable":true},"emailReplyTo":{"type":"string","nullable":true},"templateId":{"type":"number","nullable":true}},"required":["id","subject","message","timezone","dateFormat","signingOrder","typedSignatureEnabled","uploadSignatureEnabled","drawSignatureEnabled","allowDictateNextSigner","distributionMethod","redirectUrl","language","emailId","emailReplyTo","templateId"]},"directLink":{"type":"object","properties":{"id":{"type":"string"},"envelopeId":{"type":"string"},"token":{"type":"string"},"createdAt":{"type":"string","format":"date-time","nullable":true},"enabled":{"type":"boolean"},"directTemplateRecipientId":{"type":"number"},"templateId":{"type":"number"}},"required":["id","envelopeId","token","createdAt","enabled","directTemplateRecipientId","templateId"],"nullable":true},"user":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string","nullable":true},"email":{"type":"string"}},"required":["id","name","email"]},"recipients":{"type":"array","items":{"type":"object","properties":{"envelopeId":{"type":"string"},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"id":{"type":"number"},"email":{"type":"string"},"name":{"type":"string"},"token":{"type":"string"},"documentDeletedAt":{"type":"string","format":"date-time","nullable":true},"expired":{"type":"string","format":"date-time","nullable":true},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"authOptions":{"type":"object","properties":{"accessAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"actionAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."}}},"required":["accessAuth","actionAuth"],"nullable":true},"signingOrder":{"type":"number","description":"The order in which the recipient should sign the document. Only works if the document is set to sequential signing.","nullable":true},"rejectionReason":{"type":"string","nullable":true},"cuil":{"type":"string","nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true}},"required":["envelopeId","role","readStatus","signingStatus","sendStatus","id","email","name","token","documentDeletedAt","expired","expiresAt","expirationNotifiedAt","signedAt","signingOrder","rejectionReason"]}},"fields":{"type":"array","items":{"type":"object","properties":{"envelopeId":{"type":"string"},"envelopeItemId":{"type":"string"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"id":{"type":"number"},"secondaryId":{"type":"string"},"recipientId":{"type":"number"},"page":{"type":"number","description":"The page number of the field on the document. Starts from 1."},"positionX":{"nullable":true},"positionY":{"nullable":true},"width":{"nullable":true},"height":{"nullable":true},"customText":{"type":"string"},"inserted":{"type":"boolean"},"fieldMeta":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}],"nullable":true},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true}},"required":["envelopeId","envelopeItemId","type","id","secondaryId","recipientId","page","positionX","positionY","width","height","customText","inserted","fieldMeta"]}},"folder":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["DOCUMENT","TEMPLATE"]},"visibility":{"type":"string","enum":["EVERYONE","MANAGER_AND_ABOVE","ADMIN"]},"userId":{"type":"number"},"teamId":{"type":"number"},"pinned":{"type":"boolean"},"parentId":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":true}},"required":["id","name","type","visibility","userId","teamId","pinned","parentId","createdAt","updatedAt"],"nullable":true},"envelopeItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"envelopeId":{"type":"string"}},"required":["id","envelopeId"]}}},"required":["type","visibility","id","externalId","title","userId","teamId","createdAt","updatedAt","publicTitle","publicDescription","folderId","envelopeId","templateDocumentData","templateMeta","directLink","user","recipients","fields","folder","envelopeItems"]},"uploadUrl":{"type":"string","minLength":1}},"required":["template","uploadUrl"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nLas plantillas se **arman en la interfaz web** (subís el PDF, agregás los firmantes y colocás los campos). Desde la API las usás así:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nNota: los firmantes y campos de una plantilla se definen en la interfaz, no por API. La API sí permite editar firmantes y campos de un **documento** ya creado (`/documents/{id}/recipients` y `/documents/{id}/fields`)."},"get":{"summary":"Get all templates","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"default":1,"type":"number","minimum":1}},{"name":"perPage","in":"query","schema":{"default":10,"type":"number","minimum":1}}],"operationId":"getTemplates","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"directLink":{"type":"object","properties":{"token":{"type":"string"},"enabled":{"type":"boolean"}},"required":["token","enabled"],"nullable":true},"Field":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"page":{"type":"number"},"positionX":{"nullable":true},"positionY":{"nullable":true},"width":{"nullable":true},"height":{"nullable":true},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}],"nullable":true}},"required":["id","recipientId","type","page","customText"]}},"Recipient":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"signingOrder":{"type":"number","nullable":true},"authOptions":{"nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]}},"required":["id","email","name","role"]}}},"required":["id","type","title","userId","createdAt","updatedAt","directLink","Field","Recipient"]}},"totalPages":{"type":"number"}},"required":["templates","totalPages"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nLas plantillas se **arman en la interfaz web** (subís el PDF, agregás los firmantes y colocás los campos). Desde la API las usás así:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nNota: los firmantes y campos de una plantilla se definen en la interfaz, no por API. La API sí permite editar firmantes y campos de un **documento** ya creado (`/documents/{id}/recipients` y `/documents/{id}/fields`)."}},"/api/v1/templates/{id}":{"delete":{"summary":"Delete a template","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteTemplate","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","title","userId","createdAt","updatedAt"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nLas plantillas se **arman en la interfaz web** (subís el PDF, agregás los firmantes y colocás los campos). Desde la API las usás así:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nNota: los firmantes y campos de una plantilla se definen en la interfaz, no por API. La API sí permite editar firmantes y campos de un **documento** ya creado (`/documents/{id}/recipients` y `/documents/{id}/fields`)."},"get":{"summary":"Get a single template","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getTemplate","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"templateMeta":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string","nullable":true},"message":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"dateFormat":{"type":"string","nullable":true},"templateId":{"type":"number"},"redirectUrl":{"type":"string","nullable":true},"signingOrder":{"default":"PARALLEL","type":"string","enum":["PARALLEL","SEQUENTIAL"],"nullable":true}},"required":["id","templateId"],"nullable":true},"directLink":{"type":"object","properties":{"token":{"type":"string"},"enabled":{"type":"boolean"}},"required":["token","enabled"],"nullable":true},"templateDocumentData":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["S3_PATH","BYTES","BYTES_64"]},"data":{"type":"string"}},"required":["id","type","data"]},"Field":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"page":{"type":"number"},"positionX":{"nullable":true},"positionY":{"nullable":true},"width":{"nullable":true},"height":{"nullable":true},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}],"nullable":true}},"required":["id","recipientId","type","page","customText"]}},"Recipient":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"signingOrder":{"type":"number","nullable":true},"authOptions":{"nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]}},"required":["id","email","name","role"]}}},"required":["id","type","title","userId","createdAt","updatedAt","directLink","templateDocumentData","Field","Recipient"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nLas plantillas se **arman en la interfaz web** (subís el PDF, agregás los firmantes y colocás los campos). Desde la API las usás así:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nNota: los firmantes y campos de una plantilla se definen en la interfaz, no por API. La API sí permite editar firmantes y campos de un **documento** ya creado (`/documents/{id}/recipients` y `/documents/{id}/fields`)."}},"/api/v1/templates/{templateId}/create-document":{"post":{"description":"If you must use the V1 API, use \"/api/v1/templates/:templateId/generate-document\" instead.\n\n### Crear documentos desde una plantilla\n\nLas plantillas se **arman en la interfaz web** (subís el PDF, agregás los firmantes y colocás los campos). Desde la API las usás así:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nNota: los firmantes y campos de una plantilla se definen en la interfaz, no por API. La API sí permite editar firmantes y campos de un **documento** ya creado (`/documents/{id}/recipients` y `/documents/{id}/fields`).","summary":"Create a new document from an existing template","tags":[],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createDocumentFromTemplate","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"idDocumentCountry":{"type":"string","minLength":2,"maxLength":2,"description":"País del documento (ISO-3166 de 2 letras). Por defecto `AR`."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"Número del documento de identidad contra el que se valida la verificación biométrica (si `meta.requireBiometricId` está activo). El documento que presente el firmante tiene que coincidir. Si no lo mandás, el firmante lo carga antes de verificarse."},"idDocumentType":{"type":"string","maxLength":32,"description":"Tipo de documento para la verificación biométrica. Por defecto, DNI."},"firstName":{"type":"string","maxLength":255,"description":"Nombre(s) del firmante, por separado del apellido — así lo valida el proveedor biométrico. Recomendado si activás `meta.requireBiometricId`."},"lastName":{"type":"string","maxLength":255,"description":"Apellido(s) del firmante, por separado del nombre. Recomendado si activás `meta.requireBiometricId`."}},"required":["name","email"]}},"meta":{"type":"object","properties":{"subject":{"type":"string"},"message":{"type":"string"},"timezone":{"type":"string"},"dateFormat":{"type":"string"},"redirectUrl":{"type":"string"},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"]}}},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}}]},"globalActionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}]}}},"formValues":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"boolean"},{"type":"number"}]}},"attachments":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"data":{"type":"string","format":"uri"},"type":{"default":"link","type":"string","enum":["link"]}},"required":["label","data"]}}},"required":["title","recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"documentId":{"type":"number"},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"name":{"type":"string"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","nullable":true},"token":{"type":"string"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"signingUrl":{"type":"string"}},"required":["recipientId","name","email","token","signingUrl"]}}},"required":["documentId","recipients"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/templates/{templateId}/generate-document":{"post":{"description":"Create a new document from an existing template. Passing in values for title and meta will override the original values defined in the template. If you do not pass in values for recipients, it will use the values defined in the template.\n\n### Crear documentos desde una plantilla\n\nLas plantillas se **arman en la interfaz web** (subís el PDF, agregás los firmantes y colocás los campos). Desde la API las usás así:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nNota: los firmantes y campos de una plantilla se definen en la interfaz, no por API. La API sí permite editar firmantes y campos de un **documento** ya creado (`/documents/{id}/recipients` y `/documents/{id}/fields`).","summary":"Create a new document from an existing template","tags":[],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"generateDocumentFromTemplate","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"externalId":{"type":"string"},"folderId":{"type":"string","description":"The ID of the folder to create the document in. If not provided, the document will be created in the root folder."},"recipients":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$"},"name":{"type":"string"},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"signingOrder":{"type":"number"}},"required":["id","email"]}},"meta":{"type":"object","properties":{"subject":{"type":"string"},"message":{"type":"string"},"timezone":{"type":"string"},"dateFormat":{"type":"string"},"redirectUrl":{"type":"string"},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"]},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"]},"typedSignatureEnabled":{"type":"boolean"},"uploadSignatureEnabled":{"type":"boolean"},"drawSignatureEnabled":{"type":"boolean"},"emailSettings":{"nullable":true}}},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}}]},"globalActionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}]}}},"formValues":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"boolean"},{"type":"number"}]}},"prefillFields":{"type":"array","items":{"allOf":[{"type":"object","properties":{"id":{"type":"number"}},"required":["id"]},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["text"]},"label":{"type":"string"},"placeholder":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["number"]},"label":{"type":"string"},"placeholder":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["radio"]},"label":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["checkbox"]},"label":{"type":"string"},"value":{"type":"array","items":{"type":"string"}}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["dropdown"]},"label":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["date"]},"value":{"type":"string"}},"required":["type"]}]}]}}},"required":["recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"documentId":{"type":"number"},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"name":{"type":"string"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","nullable":true},"token":{"type":"string"},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"signingUrl":{"type":"string"}},"required":["recipientId","name","email","token","role","signingUrl"]}}},"required":["documentId","recipients"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/send":{"post":{"description":"Notes\n\nsendEmail - Whether to send an email to the recipients asking them to action the document. If you disable this, you will need to manually distribute the document to the recipients using the generated signing links. Defaults to true","summary":"Send a document for signing","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"sendDocument","requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"sendEmail":{"default":true,"type":"boolean","description":"Whether to send an email to the recipients asking them to action the document. If you disable this, you will need to manually distribute the document to the recipients using the generated signing links."},"sendCompletionEmails":{"type":"boolean","description":"Whether to send completion emails when the document is fully signed. This will override the document email settings."}}},{"nullable":true}],"nullable":true}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"recipients":{}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt","recipients"]}]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/resend":{"post":{"summary":"Re-send a document for signing","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"resendDocument","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"number"}}},"required":["recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/recipients":{"post":{"summary":"Create a recipient for a document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createRecipient","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"authOptions":{"type":"object","properties":{"actionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."}}]}},"description":"The authOptions property is only available for Enterprise accounts."}},"required":["name","email"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"default":-1,"type":"number","nullable":true},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"cuil":{"type":"string","nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"token":{"type":"string"},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"signingUrl":{"type":"string"}},"required":["id","email","name","role","token","signedAt","readStatus","signingStatus","sendStatus","signingUrl"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/recipients/{recipientId}":{"patch":{"summary":"Update a recipient for a document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"recipientId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"updateRecipient","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"authOptions":{"type":"object","properties":{"actionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."}}]}},"description":"The authOptions property is only available for Enterprise accounts."}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"default":-1,"type":"number","nullable":true},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"cuil":{"type":"string","nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"token":{"type":"string"},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"signingUrl":{"type":"string"}},"required":["id","email","name","role","token","signedAt","readStatus","signingStatus","sendStatus","signingUrl"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"delete":{"summary":"Delete a recipient from a document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"recipientId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteRecipient","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"default":-1,"type":"number","nullable":true},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"cuil":{"type":"string","nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"token":{"type":"string"},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"signingUrl":{"type":"string"}},"required":["id","email","name","role","token","signedAt","readStatus","signingStatus","sendStatus","signingUrl"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/fields":{"post":{"summary":"Create a field for a document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createField","requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]}},"required":["recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight"]},{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]}},"required":["recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight"]},"minItems":1}]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]},{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]}}]},"documentId":{"type":"number"}},"required":["fields","documentId"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/fields/{fieldId}":{"patch":{"summary":"Update a field for a document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"fieldId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"updateField","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"delete":{"summary":"Delete a field from a document","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"fieldId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteField","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v2/envelope/{envelopeId}/audit-log":{"get":{"summary":"Traza de auditoría del documento (v2)","operationId":"getEnvelopeAuditLogV2","description":"Devuelve la traza de auditoría completa en JSON: creación, envío, apertura, firma de cada campo, rechazo y finalización, con fecha, IP y dispositivo.\n\nSirve para archivar la evidencia de forma estructurada, además del PDF.\n\n⚠️ **Este endpoint acepta ÚNICAMENTE el `envelopeId`** (formato `envelope_...`), **no** el `id` numérico de v1 — mandarle el número devuelve `400 Invalid envelope ID`. Ver \"Los dos identificadores de un documento\" al principio de esta página.","parameters":[{"name":"envelopeId","in":"path","required":true,"description":"El `envelopeId` (`envelope_...`). Lo obtenés de `fields[].envelopeId` en `GET /api/v1/documents/{id}`.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"number"}},{"name":"perPage","in":"query","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"La traza de auditoría, paginada.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"count":{"type":"number"},"currentPage":{"type":"number"},"perPage":{"type":"number"},"totalPages":{"type":"number"}}}}}},"400":{"description":"El `envelopeId` es inválido (por ejemplo, si mandaste el `id` numérico)."},"401":{"description":"Token ausente o inválido."}}}},"/api/v2/document/{documentId}/download":{"get":{"summary":"Descargar el PDF (v2, bytes directos)","operationId":"downloadDocumentV2","description":"Devuelve directamente los bytes del PDF (`application/pdf`), a diferencia de `GET /api/v1/documents/{id}/download`, que devuelve una URL de descarga firmada.\n\nAcepta **tanto el `id` numérico** del documento (el mismo de v1) **como su `envelopeId`** (`envelope_...`) — usá el que tengas a mano.\n\nPasado el plazo de resguardo el archivo ya no existe y la respuesta es `410`.","parameters":[{"name":"documentId","in":"path","required":true,"description":"El `id` numérico del documento (el mismo que devuelve v1) o su `envelopeId` (`envelope_...`); se aceptan ambos.","schema":{"oneOf":[{"type":"number"},{"type":"string","pattern":"^envelope_"}]}},{"name":"version","in":"query","required":false,"description":"`signed` (por defecto) devuelve el documento firmado; `original` devuelve el PDF tal como se subió.","schema":{"type":"string","enum":["original","signed"]}}],"responses":{"200":{"description":"El PDF.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Token ausente o inválido."},"410":{"description":"El archivo ya fue eliminado por la política de resguardo."}}}}},"info":{"title":"Identik API","version":"1.0.0","description":"API de Identik para integraciones de clientes: creá documentos, subí el PDF, definí firmantes y campos, envialos a firmar y descargá el PDF firmado.\n\n**Autenticación:** toda solicitud lleva el encabezado `Authorization: Bearer api_...` con el token de API que te entrega Identik.\n\n### ⚠️ Los dos identificadores de un documento\n\nUn documento tiene **dos** identificadores distintos. Confundirlos es el error de integración más común:\n\n| Identificador | Formato | Dónde se usa |\n|---|---|---|\n| `id` numérico | `49` | **Todos** los endpoints `v1` (`/api/v1/documents/{id}/...`) |\n| `envelopeId` | `envelope_a1b2c3...` | La traza de auditoría `v2` (`/api/v2/envelope/{envelopeId}/audit-log`) |\n\nLa descarga `v2` (`GET /api/v2/document/{documentId}/download`) acepta **cualquiera de los dos**.\n\nLa traza de auditoría `v2` acepta **solo** el `envelopeId`: mandarle el numérico devuelve `400 Invalid envelope ID`. El `envelopeId` lo conseguís en la respuesta de `GET /api/v1/documents/{id}`, dentro de `fields[].envelopeId` (si el documento no tiene campos todavía, ese arreglo viene vacío).\n\n### Notificaciones automáticas (webhooks)\n\nIdentik te avisa por HTTP `POST` cuando cambia el estado de un documento, así no tenés que consultar en bucle.\n\nSe configuran **desde la interfaz web**, en Configuración → Webhooks (no por API): indicás la URL de destino, los eventos que querés y un secreto compartido. Cada entrega llega con el encabezado `X-Identik-Secret`, cuyo valor es ese secreto — comparalo antes de procesar el cuerpo. Toda entrega queda registrada y se puede reenviar a mano desde el panel si tu endpoint estuvo caído.\n\nEventos disponibles: `DOCUMENT_CREATED`, `DOCUMENT_SENT`, `DOCUMENT_OPENED`, `DOCUMENT_SIGNED`, `DOCUMENT_RECIPIENT_COMPLETED`, `DOCUMENT_COMPLETED`, `DOCUMENT_REJECTED`, `DOCUMENT_CANCELLED`, `RECIPIENT_EXPIRED`, `DOCUMENT_REMINDER_SENT`, más los de plantillas (`TEMPLATE_CREATED`, `TEMPLATE_UPDATED`, `TEMPLATE_DELETED`, `TEMPLATE_USED`).\n\nCuerpo de la entrega: `{ event, payload, createdAt, webhookEndpoint }`. En `payload` viaja el documento (incluido `status`) y sus firmantes con `signingStatus`, `readStatus`, `signedAt`, `expiresAt` y `rejectionReason`.\n\n**Cuidado con el vencimiento:** emitimos `RECIPIENT_EXPIRED` por cada firmante cuya ventana se cerró, pero **no existe** un evento de vencimiento a nivel documento, y el `status` del documento **no** cambia a vencido (se queda en `PENDING`). Si en tu modelo el vencimiento es un estado propio, consultá `GET /api/v1/documents/{id}` y mirá `recipients[].expiresAt` y `recipients[].expirationNotifiedAt`.\n\n### Evidencia de la firma (constancia)\n\nLa constancia de firma —quién firmó, cuándo, IP, dispositivo y hash del documento— va **incorporada como páginas del propio PDF firmado**. Descargás el documento y la evidencia en un solo archivo; no hay que pedirla aparte.\n\nAdemás, `GET /api/v2/envelope/{envelopeId}/audit-log` devuelve la traza de auditoría en JSON, por si la querés almacenar estructurada.\n\n### Plazos: ventana de firma y resguardo\n\nLa **ventana de firma** por defecto es de 1 mes, con un tope máximo de 31 días. Vencida, el enlace deja de funcionar (el documento no se borra y su `status` sigue en `PENDING` — ver la advertencia de arriba). Esta ventana no se configura por esta API.\n\nEl **resguardo** conserva el documento y su evidencia **15 días desde que el documento se cierra** (firmado, rechazado, o vencido sin firmar). Cumplido el plazo, el archivo se elimina de nuestro almacenamiento y la descarga responde `410`. La recomendación es descargar el PDF al recibir `DOCUMENT_COMPLETED` y archivarlo de tu lado. Hay resguardo extendido opcional, de hasta 5 años, configurable por cuenta.\n\n### Límites de uso (rate limits)\n\nCada dirección IP puede hacer hasta **100 solicitudes por minuto** contra esta API. Toda respuesta incluye los encabezados `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset` (época Unix, en segundos); superado el límite, la API responde `429` con el encabezado `Retry-After` indicando cuántos segundos esperar. Para lotes grandes, procesá en serie y respetá `Retry-After` antes de reintentar.\n\n### Créditos\n\nEl crédito de un documento se consume cuando el documento **se envía a firmar** (`POST /api/v1/documents/{id}/send`). Los borradores no consumen: podés crear un documento y eliminarlo antes de enviarlo sin costo. Un documento ya enviado consume su crédito aunque después venza, se rechace o se elimine.\n\n### Agentes de IA (servidor MCP)\n\nEsta plataforma expone un **servidor MCP** (Model Context Protocol) para agentes de IA en `https://electronica.identik.me/api/mcp` — transporte Streamable HTTP, sin estado, autenticado con el mismo token de API (`Authorization: Bearer api_...`).\n\nConfiguración en Claude Code:\n\n```\nclaude mcp add identik --transport http https://electronica.identik.me/api/mcp --header \"Authorization: Bearer api_...\"\n```\n\nHerramientas: `listar_plantillas`, `listar_documentos`, `obtener_documento`, `crear_documento_desde_plantilla`, `enviar_documento`, `reenviar_invitacion`, `descargar_documento_firmado`, `traza_auditoria`, `validar_pdf`, `estado_cuenta`. Funciona igual con el Agents SDK de OpenAI, Gemini CLI, Cursor y cualquier cliente MCP. Manifiesto en `/.well-known/mcp.json`; guía para agentes en `/llms.txt`.\n\n### Verificación biométrica (DNI + prueba de vida)\n\nVerificación reforzada de identidad, opcional y **por documento**: antes de poder firmar, el firmante fotografía su DNI y realiza una prueba de vida facial desde su teléfono. Se activa mandando `meta: { \"requireBiometricId\": true }` en:\n\n- `POST /api/v1/documents` — documentos creados desde cero;\n- `POST /api/v1/templates/{templateId}/generate-document` — documentos generados desde plantilla. También podés dejarla activada en la plantilla desde la interfaz web y los documentos generados la heredan; el `meta` de la llamada siempre puede sobrescribirla en ambos sentidos.\n\nConsume **créditos de verificación** prepagos — un pool a nivel de cuenta, separado del de documentos, que carga Identik cuando comprás un paquete. Cada verificación descuenta 1 crédito. Si la cuenta se queda sin créditos, el firmante firma normalmente (nunca queda bloqueado).\n\n**Fijá la identidad esperada desde la API** (recomendado): en cada elemento de `recipients[]` podés mandar `idDocumentNumber` (y opcionalmente `idDocumentType` + `idDocumentCountry`, por defecto DNI argentino) junto con `firstName` y `lastName` — el nombre y apellido **por separado**, que es como los valida el proveedor. La verificación se hace **contra esos datos**: el documento que presente el firmante tiene que coincidir. Si no los mandás, el firmante los carga él mismo antes de la verificación.\n\nEl circuito de integración no cambia: mismo `signingUrl`, mismos webhooks, misma descarga. La evidencia de la verificación (fecha y hora, tipo y número de documento, y la referencia del proveedor) queda asentada en la constancia de firma del documento.\n\nMás información: https://identik.me"},"servers":[{"url":"https://electronica.identik.me"}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","in":"header","name":"Authorization"}}},"security":[{"authorization":[]}]}