Update Session

Update a draft session before it is sent. Part of the create-review-send flow: create a draft with Create Session, review it at the returned draftUrl, revise it here as needed (the draftUrl stays the same), then send it with Send Session. Sessions that have already been sent cannot be updated - their recipients may already be signing.

Three kinds of change, combinable in one request:

• Settings: pass any of name, expiryDays, reminderEnabled, reminderFrequency alone to patch just those.
• Recipient details: pass recipients alone to fix names, emails or signing order in place. List every current recipient in signing order (same count) - recipient identities and all placed fields are preserved.
• Documents: pass files and recipients together to replace the whole document set. Send the complete spec exactly as Create Session takes it - the previous documents, fields and recipients are rebuilt from scratch, which also discards any manual edits made in the AirSign editor.

Endpoint

PUT https://api.airsign.com.au/api/v1/Session/{sessionId}

Headers

Request Body

At least one field must be provided.

Example Request - fix a recipient email

curl --location --request PUT 'https://api.airsign.com.au/api/v1/Session/{uuid}' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data '{
    "recipients": [
        { "key": "parent", "name": "Ada Lovelace", "email": "{valid_email}" }
    ]
}'

Response

Status: 200 OK - the same summary shape Create Session returns, including draftUrl (unchanged), a per-file fieldCount, and warnings (e.g. a recipient left without a signature field).

Error Responses