---
title: "Reorder Documents by Envelope ID"
method: PUT
path: "/sign/envelopes/{envelopeID}/documents:reorder"
tags: ["Sign"]
---

# Reorder Documents by Envelope ID

`PUT /sign/envelopes/{envelopeID}/documents:reorder`

The **Reorder Documents by Envelope ID** endpoint reorders all documents associated with a specific envelope based on the order specified in the request body.
Documents are returned in an `items` array within the JSON response reflecting the new order.

## Path parameters

- `envelopeID` string, uuid, required

## Request body

- ReorderDocumentsRequest — The request body should contain an array named 'order' with the document IDs in the desired sequence. This will update the order of documents within the envelope according to the provided list. Example: ```json { "order": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6", "ffa85f64-5709-6562-g3fc-1c963f66afa5" ] } ```
  - `order` string[] — An array of document IDs representing the new order of documents within the envelope.

## Response `200`

Documents reordered successfully.

- union
  - PendingDocumentResponse — Response for a pending document
    - `name` string, required — Name of the file provided by the user.
    - `createdAt` string, date-time — UTC timestamp indicating when the document was created.
    - `status` 'pending' | 'uploaded' | 'failed' | 'signed' | 'sealed' — Current status of the document.
    - `ID` string, uuid, required — Unique uuid identifier for the document.
  - UploadedDocumentResponse — Response for an uploaded document
    - `name` string, required — Name of the file provided by the user.
    - `createdAt` string, date-time — UTC timestamp indicating when the document was created.
    - `status` 'pending' | 'uploaded' | 'failed' | 'signed' | 'sealed' — Current status of the document.
    - `sizeBytes` integer — Size in bytes of the document.
    - `numPages` integer — Number of pages of the document.
    - `ID` string, uuid, required — Unique uuid identifier for the document.
  - FailedDocumentResponse — Response for a failed document
    - `name` string, required — Name of the file provided by the user.
    - `createdAt` string, date-time — UTC timestamp indicating when the document was created.
    - `status` 'pending' | 'uploaded' | 'failed' | 'signed' | 'sealed' — Current status of the document.
    - `sizeBytes` integer — Size in bytes of the document.
    - `numPages` integer — Number of pages of the document.
    - `failureReason` string — The failure reason of the document.
    - `ID` string, uuid, required — Unique uuid identifier for the document.
  - SignedDocumentResponse — Response for a signed document
    - `name` string, required — Name of the file provided by the user.
    - `createdAt` string, date-time — UTC timestamp indicating when the document was created.
    - `status` 'pending' | 'uploaded' | 'failed' | 'signed' | 'sealed' — Current status of the document.
    - `sizeBytes` integer — Size in bytes of the document.
    - `numPages` integer — Number of pages of the document.
    - `ID` string, uuid, required — Unique uuid identifier for the document.
  - SealedDocumentResponse — Response for a sealed document
    - `name` string, required — Name of the file provided by the user.
    - `createdAt` string, date-time — UTC timestamp indicating when the document was created.
    - `status` 'pending' | 'uploaded' | 'failed' | 'signed' | 'sealed' — Current status of the document.
    - `sizeBytes` integer — Size in bytes of the document.
    - `numPages` integer — Number of pages of the document.
    - `ID` string, uuid, required — Unique uuid identifier for the document.

## Other responses

- `401` — Unauthorized - Invalid or missing JWT token
- `404` — Envelope not found
- `409` — Envelope cannot be modified

---

[API](https://skmtc.net/gonitro/apis/nitro-sign-public-api.md) · [All operations](https://skmtc.net/gonitro/apis/nitro-sign-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gonitro/nitro-sign-public-api/revisions/44cfae4dc99b/schema)