Skip to main content
PUT
/
api
/
review
/
draft
Update the draft graph of the envelope under review
curl --request PUT \
  --url https://api.atlaswork.ai/api/review/draft \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "participants": [
    {
      "name": "<string>",
      "email": "jsmith@example.com"
    }
  ],
  "fields": [
    {
      "participantIndex": 1,
      "page": 2,
      "x": 0.5,
      "y": 0.5,
      "width": 0.5,
      "height": 0.5,
      "label": "<string>",
      "required": true,
      "prefillValue": "<string>"
    }
  ],
  "policy": {
    "legalFramework": "<string>",
    "consumerDisclosure": true,
    "expiresAt": "2023-11-07T05:31:56Z",
    "reminderPolicy": null
  },
  "expectedVersion": 2
}
'
{
  "envelope": {
    "id": "<string>",
    "organizationId": "<string>",
    "version": 123,
    "originalFilename": "<string>",
    "sourceFormat": "<string>",
    "contentHash": "<string>",
    "sizeBytes": 123,
    "deliveryMode": "<string>",
    "legalFramework": "<string>",
    "consumerDisclosure": true,
    "expiresAt": "2023-11-07T05:31:56Z",
    "scheduledSendAt": "2023-11-07T05:31:56Z",
    "sentAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z",
    "declinedAt": "2023-11-07T05:31:56Z",
    "voidedAt": "2023-11-07T05:31:56Z",
    "expiredAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "reminderPolicy": null,
    "metadata": null
  },
  "participants": [
    {
      "id": "<string>",
      "envelopeId": "<string>",
      "organizationId": "<string>",
      "orderIndex": 123,
      "name": "<string>",
      "email": "<string>",
      "consentedAt": "2023-11-07T05:31:56Z",
      "signedAt": "2023-11-07T05:31:56Z",
      "declinedAt": "2023-11-07T05:31:56Z",
      "declineReason": "<string>",
      "lastViewedAt": "2023-11-07T05:31:56Z",
      "lastIpAddress": "<string>",
      "lastUserAgent": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "fields": [
    {
      "id": "<string>",
      "envelopeId": "<string>",
      "organizationId": "<string>",
      "participantId": "<string>",
      "page": 123,
      "x": 123,
      "y": 123,
      "width": 123,
      "height": 123,
      "label": "<string>",
      "required": true,
      "prefillValue": "<string>",
      "value": "<string>",
      "filledAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

HMAC-signed review token (minted into the envelope's review URL at creation), as a bearer token or a token query param. Capabilities are split per token: a read token grants view + draft editing, a send token grants the dispatch action only — so a forwarded review link can be shared read-only. Scoped to exactly one envelope; never valid as a signer credential.

Body

application/json
​
participants
object[]
​
fields
object[]
​
policy
object
​
expectedVersion
integer
Required range: x >= 1

Response

The updated envelope graph (final version after all bumps)

​
envelope
object
required
​
participants
object[]
required
​
fields
object[]
required