Updates a specific upload request | Docusign

curl -X PUT https://api-d.docusign.com/v1/accounts/accountId/workspaces/workspaceId/upload-requests/uploadRequestId \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Updated Document Collection",
  "description": "Upload initial purchase documents - deadline extended.",
  "status": "draft",
  "due_date": "2025-09-11T12:00:00Z",
  "assignments": null
}'

{
  "upload_request_id": "8d7c6b5a-4f3e-2d1c-b9a8-7e6f5d4c3b2a",
  "workspace_id": "113e81b7-706e-4cab-9257-73b06325266e",
  "name": "Contract Documents Upload",
  "upload_request_owner": {
    "user_id": "211e2d22-f070-4c8d-b6a7-ecb14ceb81b4"
  },
  "status": "in_progress",
  "documents": [
    {
      "document_name": "Contract Agreement.pdf",
      "document_id": "9e2f4a8b-3c7d-4e5f-a1b2-8c9d6e3f4a7b"
    }
  ],
  "assignments": [
    {
      "assignee_user_id": "3b2c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e"
    }
  ],
  "created_date": "2025-09-01T12:00:00Z",
  "updated_date": "2025-09-01T12:00:00Z",
  "description": "Please upload the signed contract documents for review",
  "due_date": "2025-09-08T12:00:00Z",
  "sent_date": "2025-09-01T12:00:00Z",
  "completed_date": null
}

This operation updates a specific upload request within a workspace. Only draft upload requests can be edited. The editable fields are name, description, due date, and status. Status changes are restricted - only transitions from draft to in_progress are allowed. Attempting to update a non-draft upload request will result in an INVALID_STATUS error. Attempting an invalid status change will result in an INVALID_STATUS_CHANGE error.

Required authentication scopes: dtr.rooms.write

Authentication

AuthorizationBearer

JWT Bearer token from Docusign authorization server

Path parameters

accountIdstringRequiredformat: "uuid"

The ID of the account

workspaceIdstringRequiredformat: "uuid"

The ID of the workspace

uploadRequestIdstringRequiredformat: "uuid"

The ID of the upload request to update

Request

The upload request object with updated values

namestring or nullRequired

The name of the upload request (editable)

descriptionstring or nullRequired

The description of the upload request (editable)

statusenumRequired

Enum representing the status of a workspace upload request

Allowed values:

due_datedatetime or nullOptional

The due date for the upload request (editable)

assignmentslist of objects or nullOptional

List of user assignments for the upload request

Response

Upload request successfully updated

upload_request_idstringformat: "uuid"

The ID of the upload request

workspace_idstringformat: "uuid"

The ID of the workspace

namestring or null

The name of the upload request

upload_request_ownerobject

statusenum

Enum representing the status of a workspace upload request

Allowed values:

documentslist of objects or null

List of documents associated with the upload request

assignmentslist of objects or null

List of user assignments for the upload request

created_datedatetime or null

The date the upload request was created

updated_datedatetime or null

The date the upload request was last updated

descriptionstring or nullOptional

The description of the upload request

due_datedatetime or nullOptional

The due date for the upload request

sent_datedatetime or nullOptional

The date the upload request was sent

completed_datedatetime or nullOptional

The date the upload request was completed

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error