{"openapi":"3.0.2","paths":{"/api/v1/documents":{"get":{"summary":"Listar documentos","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":"Crear un documento y obtener la URL prefirmada para subir el PDF","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"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$","description":"No disponible todavía en esta cuenta. Mandarlo hace que el pedido falle con 400; el firmante recibe el link por email."},"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."},"sendViaWhatsapp":{"default":false,"type":"boolean","description":"No disponible todavía en esta cuenta. Mandarlo en `true` hace que el pedido falle con 400."},"sendViaSms":{"default":false,"type":"boolean","description":"No disponible todavía en esta cuenta. Mandarlo en `true` hace que el pedido falle con 400."},"requireWhatsappOtp":{"default":false,"type":"boolean","description":"No disponible todavía en esta cuenta. Mandarlo en `true` hace que el pedido falle con 400."},"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},"phone":{"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},"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":"Obtener un documento","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":{},"meta":{"type":"object","properties":{"requireBiometricId":{"type":"boolean"},"requireWhatsappOtp":{"type":"boolean"},"sendViaWhatsapp":{"type":"boolean"},"sendViaSms":{"type":"boolean"},"language":{"type":"string","nullable":true}},"required":["requireBiometricId","requireWhatsappOtp","sendViaWhatsapp","sendViaSms"]},"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":"Eliminar un documento","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":"Descargar el documento firmado (requiere almacenamiento 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"]}}}}},"description":"Devuelve JSON con downloadUrl, no bytes PDF. Descargá el archivo desde esa URL firmada; no envíes el API token a la URL de almacenamiento. Para bytes directos usá GET /api/v2/document/{documentId}/download. Verificá status=COMPLETED antes de tratarlo como documento final."}},"/api/v1/templates":{"post":{"summary":"Crear una plantilla y obtener la URL prefirmada para subir el PDF","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."},"recipients":{"type":"array","items":{"type":"object","properties":{"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,"maxLength":254},"name":{"type":"string","maxLength":255},"cuil":{"type":"string","maxLength":20,"nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number"},"accessAuth":{"default":[],"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"actionAuth":{"default":[],"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."}},"fields":{"type":"array","items":{"allOf":[{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["SIGNATURE"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["FREE_SIGNATURE"]},"fieldMeta":{}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["INITIALS"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["NAME"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["EMAIL"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["DATE"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["TEXT"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["NUMBER"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["RADIO"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["CHECKBOX"]},"fieldMeta":{"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"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["DROPDOWN"]},"fieldMeta":{"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":["type"]}]},{"type":"object","properties":{"pageNumber":{"type":"number","minimum":1,"description":"The page number the field will be on."},"pageX":{"type":"number","minimum":0,"description":"The X coordinate of where the field will be placed."},"pageY":{"type":"number","minimum":0,"description":"The Y coordinate of where the field will be placed."},"width":{"type":"number","minimum":1,"description":"The width of the field."},"height":{"type":"number","minimum":1,"description":"The height of the field."}},"required":["pageNumber","pageX","pageY","width","height"]}]}}},"required":["email","name","role"]}},"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},"phone":{"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\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\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\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`)."},"get":{"summary":"Listar plantillas","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\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\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\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`)."}},"/api/v1/templates/{id}":{"delete":{"summary":"Eliminar una plantilla","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\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\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\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`)."},"get":{"summary":"Obtener una plantilla","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\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\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\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/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\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\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\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`).","summary":"Crear un documento a partir de una plantilla","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"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$","description":"No disponible todavía en esta cuenta. Mandarlo hace que el pedido falle con 400; el firmante recibe el link por email."},"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},"phone":{"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},"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\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\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\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`).","summary":"Crear un documento a partir de una plantilla (con valores)","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"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$","description":"No disponible todavía en esta cuenta. Mandarlo hace que el pedido falle con 400; el firmante recibe el link por email."},"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`."},"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},"requireBiometricId":{"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."},"sendViaWhatsapp":{"type":"boolean","description":"No disponible todavía en esta cuenta. Mandarlo en `true` hace que el pedido falle con 400."},"sendViaSms":{"type":"boolean","description":"No disponible todavía en esta cuenta. Mandarlo en `true` hace que el pedido falle con 400."},"requireWhatsappOtp":{"type":"boolean","description":"No disponible todavía en esta cuenta. Mandarlo en `true` hace que el pedido falle con 400."}}},"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},"phone":{"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},"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":"Enviar un documento a firmar","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":{},"meta":{"type":"object","properties":{"requireBiometricId":{"type":"boolean"},"requireWhatsappOtp":{"type":"boolean"},"sendViaWhatsapp":{"type":"boolean"},"sendViaSms":{"type":"boolean"},"language":{"type":"string","nullable":true}},"required":["requireBiometricId","requireWhatsappOtp","sendViaWhatsapp","sendViaSms"]}},"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":"Reenviar la invitación a firmar","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":"Agregar un destinatario al documento","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"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"},"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},"phone":{"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},"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":"Actualizar un destinatario del documento","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"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"},"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},"phone":{"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},"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":"Quitar un destinatario del documento","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},"phone":{"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},"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":"Agregar un campo al documento","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":"Actualizar un campo del documento","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":"Quitar un campo del documento","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\nSi el archivo ya no está disponible, la ruta devuelve 404. Archivá el PDF al completar; no dependas de 410 para detectar el fin del resguardo.","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 archivo vigente, sin garantizar que todos hayan firmado. Verificá status=COMPLETED antes de tratarlo como final; `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":"Código histórico documentado; la ruta vigente responde 404 si no encuentra el archivo. No dependas de 410 para detectar el fin del resguardo."}}}},"/api/v2/document/{documentId}/certificate":{"get":{"summary":"Descargar la constancia de firma (v2, PDF aparte)","operationId":"downloadDocumentCertificateV2","description":"Devuelve la **constancia de firma** como un PDF independiente (`application/pdf`, bytes directos): quién firmó, cuándo, IP, dispositivo, sellos de tiempo y el hash SHA-256 del PDF firmado.\n\nEn esta plataforma la constancia ya va incorporada al final del PDF firmado; este endpoint es para quien además la quiere como archivo separado.\n\nSe genera desde la evidencia guardada en el momento de la llamada, con el mismo generador que el botón «Descargar constancia» de la interfaz y que el adjunto del correo.\n\nAcepta **tanto el `id` numérico** del documento **como su `envelopeId`** (`envelope_...`). Disponible con `COMPLETED` o `REJECTED`; en un rechazo acredita ese resultado, no firmas completas. `DRAFT` y `PENDING` responden `409`.","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_"}]}}],"responses":{"200":{"description":"La constancia de firma en PDF (`Content-Disposition: attachment`).","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Token ausente o inválido."},"404":{"description":"El documento no existe o no pertenece a tu equipo."},"409":{"description":"El documento sigue DRAFT/PENDING (`code: DOCUMENT_NOT_COMPLETE`). COMPLETED y REJECTED permiten constancia; un rechazo no acredita firmas completas."}}}}},"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. Si igual la querés como PDF separado, `GET /api/v2/document/{documentId}/certificate` la devuelve (con el documento COMPLETED o REJECTED; un rechazo genera evidencia de ese resultado).\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 puede eliminarse de nuestro almacenamiento y dejar de estar disponible para descarga; no dependas de un código HTTP único para detectar el fin del resguardo. La recomendación es descargar el PDF al recibir `DOCUMENT_COMPLETED` y archivarlo de tu lado. Hay resguardo extendido opcional, de hasta 10 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. Las respuestas que pasan por el limitador de aplicación incluyen 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. Una capa de acceso puede rechazar antes y sin esos headers. 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\nLos extras opcionales tienen **pools de crédito propios**, separados del de documentos, que también carga Identik al comprar un paquete:\n\n| Pool | Se consume | Si se agota |\n|---|---|---|\n| Documentos | al enviar a firmar | no se pueden crear más documentos |\n| Verificación de identidad | por cada verificación **aprobada** | el firmante firma normalmente, sin verificarse |\n\nNinguno de los pools de extras vence. Los saldos se consultan con la herramienta `estado_cuenta` del servidor MCP.\n\n### Agentes de IA (servidor MCP)\n\nEsta plataforma expone un **servidor MCP** (Model Context Protocol) para agentes de IA en `https://sandbox-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://sandbox-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`, `descargar_constancia`, `traza_auditoria`, `validar_pdf`, `estado_cuenta`. `crear_documento_desde_plantilla` acepta `telefono` por firmante y `avisar_por_whatsapp` a nivel documento, y `estado_cuenta` informa los saldos de los cuatro pools. 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://sandbox-electronica.identik.me"}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","in":"header","name":"Authorization"}}},"security":[{"authorization":[]}]}