Reordering Documents

While you're building your transaction via API, you may leave it in a draft state while you add, change, and remove documents to it. Whenever you add a new document to a transaction, it will be positioned at the end of the documents array, meaning it will be the last document presented to the signer.

Understandably, document order matters in some signing ceremonies. Using our Update Transaction endpoint, you can provide the preferred order of each document in the transaction.

Retrieve Document IDs

You can use the Retrieve Transaction endpoint to retrieve the id of each document in a transaction.

Reorder Documents

Call the Update Transaction endpoint with your preferred bundle_position (indexed by 0) of each document in the transaction, in the exact format as shown below:

PUT /transactions/ot_xxxxxxx
{
    "documents": [
        {
            "document_id": "do_c21d948a-40d8-4bb7-aedd-8f5c7e929407",
            "bundle_position": 0
        },
        {
            "document_id": "do_106e8252-9d75-4f71-93da-cdaacef98166",
            "bundle_position": 1
        },
        {
            "document_id": "do_4cfc3e76-6424-43b4-84d0-9675056806e6",
            "bundle_position": 2
        }
        
    ]
}