Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-24122271451.2 KB
Documents

Create Document Editing Session

Creates a new editing session for the Embedded Editor. The response includes an E-Token, which is required to open the document.

🚧 Important: The Embedded Editor can only open documents that have a draft status.

Limitations

  • Single Active Session per User-Document Pair Only one editing session can be active at a time for a specific user and document. Creating a new session for the same user-document pair will automatically invalidate the previous one.

  • Weekly Session Cap A maximum of 250 editing sessions can be created for a single document per week. Any attempt to exceed this limit will result in a 403 Forbidden error.

post/public/v1/documents/{id}/editing-sessions

Path parameters

idstring required

Document ID

Request body

emailstring email required

Email of the user to create the editing session for

lifetimeinteger

Lifetime of the E-Token in seconds.

Example request

{
  "email": "john.doe@pandadoc.com",
  "lifetime": 3600
}

Response

Document Editing Session created

idstring

Internal id of the editing session. Don't use it, it's not a token.

emailstring email

Email associated with the editing session.

expires_atstring date-time

Date and time when the editing session expires.

keystring

Same value as token, token for the embedded editor, aka E-Token. Deprecated — use token instead.

tokenstring

Token for the embedded editor, aka E-Token. Use it for your Embedding.

document_idstring

ID of the document

Example response

{
  "id": "ce9825e5-3210-4a8f-1230-f32b643295d2",
  "email": "eric@pandadoc.com",
  "expires_at": "2025-01-10T00:09:09.612651Z",
  "key": "985b695b56eaaa571e9bb8e522afd5bd335c32d7",
  "token": "985b695b56eaaa571e9bb8e522afd5bd335c32d7",
  "document_id": "pSgK5XYZjyg3zXYZxsoUWg"
}