Gets upload requests within a workspace

GET

/v1/accounts/:accountId/workspaces/:workspaceId/upload-requests

GET

/v1/accounts/:accountId/workspaces/:workspaceId/upload-requests

curl https://api-d.docusign.com/v1/accounts/accountId/workspaces/workspaceId/upload-requests \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "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
    },
    {
      "upload_request_id": "5a4b3c2d-1e9f-8a7b-6c5d-4e3f2a1b9c8d",
      "workspace_id": "113e81b7-706e-4cab-9257-73b06325266e",
      "name": "Employee Onboarding Documents",
      "upload_request_owner": {
        "user_id": "211e2d22-f070-4c8d-b6a7-ecb14ceb81b4"
      },
      "status": "complete",
      "documents": [],
      "assignments": [
        {
          "assignee_user_id": "4c3d5e6f-7a8b-9c0d-1e2f-3a4b5c6d7e8f"
        }
      ],
      "created_date": "2025-08-22T12:00:00Z",
      "updated_date": "2025-08-29T12:00:00Z",
      "description": "Upload required documents for new employee onboarding",
      "due_date": "2025-08-29T12:00:00Z",
      "sent_date": "2025-08-22T12:00:00Z",
      "completed_date": "2025-08-29T12:00:00Z"
    }
  ]
}

This operation retrieves a list of upload requests within a workspace. Each upload request includes details such as ID, name, description, status, owner information, associated documents, assignments, and various dates.

Required authentication scopes: dtr.rooms.read

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

Response

Upload requests successfully retrieved

datalist of objects or null

The upload request list

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error