Skip to Content

Change a sent document's expiration date

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/documents/{id}/extend-expiration

Change the expiration date of a document that has already been sent for signing. The new date can be earlier or later than the current one.

Status Requirements:

  • Document must be in PENDING or EXPIRED status. An EXPIRED document returns to PENDING. For DRAFT documents, set expiresAt via PATCH /api/v1/documents/{id} instead.

Permissions:

  • Requires the EDIT_DOCUMENT workspace permission.

Request Body:

  • expiresAt (required) - The new expiration date/time (ISO 8601). Must be at least 24 hours in the future.

What happens:

  1. The document's expiresAt is updated.
  2. An audit log entry is recorded.
  3. Every recipient that is still notifiable (has an email, notifications enabled, delivery method other than NONE, and has not rejected) is emailed that the signing deadline has moved.

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Path Parameters

id*string

Header Parameters

authorization*string

Bearer token for API authentication

Idempotency-Key?string

Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.

Lengthlength <= 255

Request Body

Body

application/json
  1. body

Change the expiration date of a PENDING or EXPIRED document. Recipients are notified that the deadline moved.

expiresAt*string

New expiration date/time (ISO 8601). Must be at least 24 hours in the future. Can be earlier or later than the current expiration.

Formatdate-time

Response Body

200

application/json
  1. response
id*string

Unique document identifier

externalId?|

Your external reference ID for this document

expiresAt?|

Date and time when the document expires

Formatdate-time
name*string

Document name/title

status*string

Document status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED

documentMeta?|

Document metadata including subject, message, signing order, etc.

createdAt*string

Date and time when the document was created

Formatdate-time
updatedAt*string

Date and time when the document was last updated

Formatdate-time
completedAt?|

Date and time when all signers completed signing

Formatdate-time
Example Request
curl -X POST 'https://app.sajn.se/api/v1/documents/string/extend-expiration' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "expiresAt": "2019-08-24T14:15:22Z"}'
Example Response
{  "id": "string",  "externalId": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "name": "string",  "status": "string",  "documentMeta": {    "subject": "string",    "message": "string",    "signingOrder": "PARALLEL",    "forceReadFullDocument": true,    "showChatToSigners": true,    "preferredLanguage": "sv",    "value": "string",    "redirectUrl": "string",    "redirectEnabled": true,    "internalRecipients": [      "string"    ],    "signableAfterExpired": true,    "sendPlainTextEmailOnly": true,    "reminderIntervalDays": "string",    "allowDelegation": true,    "accessVerification": "NONE",    "aiChatEnabled": true,    "ssnDisplayMode": "FULL",    "sameDeviceSigning": true,    "documentCategoryId": "string"  },  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "completedAt": "2019-08-24T14:15:22Z"}

Was this page helpful?