Replace invite recipient
update_invite_recipientUpdate a pending signing invite by replacing the current recipient with a new email address for a document or document group.
Instructions
Replace the signing recipient on a pending field invite for a document or document group. Finds the pending invite for the current signer and replaces it with a new signer. For documents: deletes the old invite, creates a replacement, and triggers sending. For document groups: updates the pending step(s) with the new signer information. Only field invites are supported — freeform and embedded invites cannot be updated. The entity's state may have changed in the SignNow editor since you last looked — re-read the current state first and build this request from the current roles/recipients, not from earlier in the conversation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Role name to match (for multi-role documents). If omitted, matches any role. | |
| entity_id | Yes | ID of the document or document group | |
| new_email | Yes | Email address of the new signer | |
| entity_type | No | Type of entity: 'document' or 'document_group' (optional). Auto-detected if not provided (tries document_group first). Pass explicitly to save one API call. | |
| current_email | Yes | Email address of the current signer to replace |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Result status: 'replaced' (invite recipient was replaced and resent), 'no_pending_invite' (no pending/created invite found for current_email), 'unsupported_invite_type' (freeform or embedded invites cannot be updated) | |
| entity_id | Yes | Document or document group ID | |
| new_email | Yes | Email address of the new signer | |
| entity_type | Yes | Entity type: 'document' or 'document_group' | |
| new_invite_id | No | ID of the newly created invite (populated only when status is 'replaced') | |
| updated_steps | No | List of step IDs that were updated (populated only for document_group with status 'replaced') | |
| previous_email | Yes | Email address of the replaced signer |