Skip to main content
POST
Update
Package updates can be broken up into the following categories:
  • Modifying Package Properties (Name, Meeting, Sign by Date, …)
  • Modifying Signers (Add, Update, and Delete)
  • Modifying Documents (Add, Update, and Delete)
  • Moving Packages (Move to Member or Team folder)

Document regeneration & renotification

Depending on the changes made during a package update, a document may be regenerated, and update notifications may be sent to signers.
  • Updating a document that has already been signed or partially signed will result in regenerating the document and requiring the document to be re-signed. A notification will also be sent out to the affected signer(s), notifying them that the package has been updated and to re-sign the documents.
  • Updating a signer’s email address will result in sending a new notification to the signer’s new email address.
  • Updating a signer’s email address will result in all previous signer links being invalidated.
  • Updating a signer’s mobile number will result in all previous mobile signer links being invalidated.

Request

Adding

Request

Updating

Request
Set returnPackage to false if you do not need the updated package included in the response. If you set generateSignerLinks to true, the updated package will always be returned.

Moving

You can move a package to a member or team folder by specifying the folderId along with the memberId or teamId. If you want to move the package to the root of the member or team, set the folderId to null.
You must have the necessary permissions to move packages to the specified member or team folder.
Request

Deleting

Request

Body

string
required
Unique identifier of the package to update
string
Name of the package.
string
Category of the package.
string
Description of the package.
string
Message to be shared to all signers.
string
Date by which the document should be signed. After this date, the package will expire and can no longer be signed unless extended.
string
Security passphrase for the package.
object
Additional options for the package.
string
There are limitations on how you can transition between package states using this endpoint:
If the current package state is select or add, the package will be automatically transitioned to the draft state when updated.To prevent this automatic transition, set the state to select or add explicitly to maintain the current state.
If the current package state is draft, you can transition back to add by setting the state to add.This is useful when using the embedded package editor and you want to maintain the add state.
If the package is in a select, add, or draft state, you can send the package to transition to the open state.
If the package is in an open state, you can rescind or delete the package.
object
Details about the meeting associated with the package.
object
Move a package to another member, team, or folder.
You can easily copy teamId and folderId from Teams and Folders management pages within the iinked Sign portal.
string
The member ID to move a package to.
string
The team ID to move a package to.
string
The folder ID to move a package to.
object[]
Documents to add to the package.
Must provide one of fileBase64, fileUrl, or fileId.
object[]
Documents to update in the package.
object[]
Documents to delete from the package.
object[]
Signers to add to the package.
object[]
Signers to update in the package.
object[]
Signers to delete from the package.
object[]
Recipients to add to the package.
object[]
Recipients to update in the package.
object[]
Recipients to delete from the package.
boolean
default:false
Add new signers and update existing signers in user’s contacts.
Set to true to return links you can use to integrate document signing workflows. If you set generateSignerLinks to true during packages/add, packages/update will automatically generate new signer links unless you explicitly set generateSignerLinks to false.
boolean
default:false
Return updated package with response.

Response

string
Unique identifier for the package.
object
Full package object, returned when returnPackage is set to true on the request.
object[]
List of contacts created during package updates, returned when addSignersToContacts is set to true on the request.