/* tslint:disable */ /* eslint-disable */ /** * Dropsigner *

Authentication

In order to call this APIs, you will need an API key. Set the API key in the header X-Api-Key:

X-Api-Key: your-app|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

HTTP Codes

The APIs will return the following HTTP codes:

Code Description
200 (OK) Request processed successfully. The response is different for each API, please refer to the operation's documentation
400 (Bad Request) Syntax error. For instance, when a required field was not provided
401 (Unauthorized) API key not provided or invalid
403 (Forbidden) API key is valid, but the application has insufficient permissions to complete the requested operation
422 (Unprocessable Entity) API error. The response is as defined in ErrorModel

Error Codes

Some of the error codes returned in a 422 response are provided bellow*:

*The codes shown above are the main error codes. Nonetheless, this list is not comprehensive. New codes may be added anytime without previous warning.


Webhooks

It is recomended to subscribe to Webhook events instead of polling APIs. To do so, enable webhooks and register an URL that will receive a POST request whenever one of the events bellow occur.

All requests have the format described in Webhooks.WebhookModel. The data field varies according to the webhook event type:

Event type Description Payload
DocumentSigned Triggered when a document is signed. Webhooks.DocumentSignedModel
DocumentApproved Triggered when a document is approved. Webhooks.DocumentApprovedModel
DocumentRefused Triggered when a document is refused. Webhooks.DocumentRefusedModel
DocumentConcluded Triggered when the flow of a document is concluded. Webhooks.DocumentConcludedModel
DocumentCanceled Triggered when the document is canceled. Webhooks.DocumentCanceledModel
DocumentExpired (v1.33.0) Triggered when the document is expired. Webhooks.DocumentExpiredModel
DocumentsCreated (v1.50.0) Triggered when one or more documents are created. Webhooks.DocumentsCreatedModel
DocumentsDeleted (v1.78.0) Triggered when one or more documents are deleted. Webhooks.DocumentsDeletedModel

To register your application URL and enable Webhooks, access the integrations section in your organization's details page.

* * OpenAPI spec version: 2.6.0 * * * NOTE: This class is auto generated by the swagger code generator program. * https://github.com/swagger-api/swagger-codegen.git * Do not edit the class manually. */ import { AttachmentsAttachmentUploadModel } from './attachments-attachment-upload-model'; import { DocumentsDocumentAdditionalInfoData } from './documents-document-additional-info-data'; import { DocumentsDocumentTagData } from './documents-document-tag-data'; import { FileUploadModel } from './file-upload-model'; import { FlowActionsFlowActionCreateModel } from './flow-actions-flow-action-create-model'; import { ObserversObserverCreateModel } from './observers-observer-create-model'; import { SignatureTypes } from './signature-types'; import { UploadModel } from './upload-model'; import { XmlNamespaceModel } from './xml-namespace-model'; /** * * @export * @interface DocumentsCreateDocumentRequest */ export interface DocumentsCreateDocumentRequest { /** * The files to submit. Each file will create a document. * @type {Array} * @memberof DocumentsCreateDocumentRequest */ files: Array; /** * The attachments to submit. Each document will have the same attachments. * @type {Array} * @memberof DocumentsCreateDocumentRequest */ attachments?: Array | null; /** * Optional parameter for XML documents. This namespace will be used by all files in Lacuna.Signer.Api.Documents.CreateDocumentRequest.Files. * @type {Array} * @memberof DocumentsCreateDocumentRequest */ xmlNamespaces?: Array | null; /** * If true, groups all files into a single document (the envelope). All files must be in PDF format. * @type {boolean} * @memberof DocumentsCreateDocumentRequest */ isEnvelope?: boolean; /** * The name of the document if the envelope option is enabled (see \"IsEnvelope\" property). * @type {string} * @memberof DocumentsCreateDocumentRequest */ envelopeName?: string | null; /** * * @type {UploadModel} * @memberof DocumentsCreateDocumentRequest */ participantsDataFile?: UploadModel; /** * * @type {{ [key: string]: string; }} * @memberof DocumentsCreateDocumentRequest */ templateFieldValues?: { [key: string]: string; } | null; /** * The id of the folder in which the document should be placed or null if it should not be placed in any specific folder. * @type {string} * @memberof DocumentsCreateDocumentRequest */ folderId?: string | null; /** * A description to be added to the document(s). This will be presented to all participants in the document details screen and in pending action notifications. * @type {string} * @memberof DocumentsCreateDocumentRequest */ description?: string | null; /** * The list of actions (signers and approvers) that will be in the document. * @type {Array} * @memberof DocumentsCreateDocumentRequest */ flowActions: Array; /** * * @type {Array} * @memberof DocumentsCreateDocumentRequest */ observers?: Array | null; /** * If true the notifications of pending actions won't be sent to the participants of the first step. * @type {boolean} * @memberof DocumentsCreateDocumentRequest */ disablePendingActionNotifications?: boolean; /** * If true, no notifications will be sent to participants of this document. * @type {boolean} * @memberof DocumentsCreateDocumentRequest */ disableNotifications?: boolean; /** * The name of a new folder to be created and associated to the document. If you do not wish to create a new folder you may set this as null. * @type {string} * @memberof DocumentsCreateDocumentRequest */ newFolderName?: string | null; /** * If this property is set to true, then the document will be signed using the CAdES format. * @type {boolean} * @memberof DocumentsCreateDocumentRequest */ forceCadesSignature?: boolean; /** * The emails to notify when the document is concluded. * @type {Array} * @memberof DocumentsCreateDocumentRequest */ notifiedEmails?: Array | null; /** * * @type {DocumentsDocumentAdditionalInfoData} * @memberof DocumentsCreateDocumentRequest */ additionalInfo?: DocumentsDocumentAdditionalInfoData; /** * * @type {Array} * @memberof DocumentsCreateDocumentRequest */ tags?: Array | null; /** * * @type {SignatureTypes} * @memberof DocumentsCreateDocumentRequest */ signatureType?: SignatureTypes; /** * * @type {string} * @memberof DocumentsCreateDocumentRequest */ securityContextId?: string | null; /** * * @type {string} * @memberof DocumentsCreateDocumentRequest */ templateId?: string | null; /** * The expiration date of the document. Any time information will be discarded, as the expiration will be set to the last time available for the chosen date in the default timezone. * @type {Date} * @memberof DocumentsCreateDocumentRequest */ expirationDate?: Date | null; }