Mark bulk job upload as complete | Docusign

{
  "id": "1d4dbfd5-6911-47a7-93fa-f597975f7d2d",
  "name": "Q4 2025 Contracts",
  "status": "OPEN",
  "status_enum": [
    "OPEN",
    "UPLOAD_COMPLETE",
    "IN_PROGRESS",
    "COMPLETE",
    "FAILED",
    "CANCELED"
  ],
  "created_at": "2025-10-27T19:11:42Z",
  "modified_at": "2025-10-27T19:11:42Z",
  "expires_at": "2025-10-28T03:11:42Z",
  "metadata": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "response_timestamp": "2025-10-27T19:11:42Z",
    "response_duration": 150
  },
  "external_job_id": "string",
  "ttl_period": "PT8H",
  "upload_settings": {
    "ai_extraction": true
  },
  "ai_processing": {
    "resume_ai_triggered_at": "2026-06-09T10:00:00Z",
    "processed": 85,
    "skipped": 15,
    "in_progress": 10,
    "failed": 5
  },
  "summary": {
    "total": 1,
    "agreements_created": 1,
    "failed": 1,
    "canceled": 1,
    "in_progress": 1
  },
  "_embedded": {
    "document_status_enum": [
      "NOT_STARTED",
      "IN_PROGRESS",
      "CANCELED",
      "SUCCEEDED",
      "SUCCEEDED_WITH_WARNINGS",
      "FAILED"
    ],
    "documents": [
      {
        "id": "8c566d26-e7fb-4b7e-870c-1d0fb8df9084",
        "agreement_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "sequence": 1,
        "status": "NOT_STARTED",
        "file_name": "filename.pdf",
        "ai_extraction": true,
        "error_code": 1,
        "error": "string",
        "warnings": [
          {
            "code": "METADATA_APPLICATION_FAILED",
            "message": "Applying metadata failed",
            "recoverable": true,
            "detail": "string",
            "remedy": "update_metadata"
          }
        ],
        "is_duplicate": false,
        "_actions": {
          "upload_document": "https://docupstoragewestwu3dsto.blob.core.windows.net/1d4dbfd5-6911-47a7-93fa-f597975f7d2d/8c566d26-e7fb-4b7e-870c-1d0fb8df9084?sv=2023-01-03&st=2025-10-27T19%3A11%3A42Z&se=2025-10-28T03%3A16%3A42Z&sr=b&sp=cw&sig=st%2Fot4COaU9icCNYbEfm7RdKJhjxgfi4Oo0HSEZ7EMQ%3D",
          "update_metadata": {
            "href": "https://example.com/resource/123",
            "method": "POST",
            "required": false,
            "sequence": 1,
            "description": "string",
            "template_variables": {},
            "headers": {},
            "constraints": null,
            "success_status_code": 200
          }
        },
        "_links": {
          "document": {
            "href": "https://s1.us.services.demo.docusign.net/document-public-dms/v1/accounts/{accountId}/documents/{documentId}"
          },
          "agreement": {
            "href": "/v1/accounts/{accountId}/agreements/{agreementId}"
          }
        }
      }
    ],
    "duplicate_count": 0
  },
  "_action_templates": {
    "upload_document": {
      "method": "PUT",
      "required": true,
      "description": "Upload document file to Azure Blob Storage",
      "template_variables": {},
      "headers": {
        "Content-Type": "application/pdf",
        "x-ms-blob-type": "BlockBlob",
        "x-ms-meta-metadata": "{\"provisions\":{\"jurisdiction\":\"California\"},\"custom_provisions\":{\"c_ClientId\":\"value\"}}"
      },
      "constraints": {
        "max_size_mb": 100,
        "max_documents_per_job": 10000,
        "allowed_formats": [
          "pdf",
          "docx",
          "txt"
        ],
        "timeout_seconds": 300
      },
      "success_status_code": 201,
      "error_status_codes": {}
    }
  },
  "_links": {
    "self": "https://api.docusign.com/v1/accounts/12345678-1234-1234-1234-123456789012/upload/jobs/1d4dbfd5-6911-47a7-93fa-f597975f7d2d"
  },
  "constraints": {
    "max_size_mb": 100,
    "max_documents_per_job": 10000,
    "allowed_formats": [
      "pdf",
      "docx",
      "txt"
    ],
    "timeout_seconds": 300
  },
  "message": "Files exceeding 100MB or more than 10,000 per job will be rejected."
}

Mark the upload of documents as complete for a bulk job. End user won’t upload more docs for this job.

Important: Only call this endpoint after successfully uploading all documents to their respective pre-signed URLs obtained from the create job response.

Authentication

AuthorizationBearer

OAuth2 authentication.

Demo:
- authorizationUrl: https://account-d.docusign.com/oauth/auth
- tokenUrl: https://account-d.docusign.com/oauth/token
Production:
- authorizationUrl: https://account.docusign.com/oauth/auth
- tokenUrl: https://account.docusign.com/oauth/token

Path parameters

accountIdstringRequiredformat: "^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$"

jobIdstringRequiredformat: "^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$"

Response

The updated bulk job

idstringformat: "uuid"

Id for job

namestring

User provided name for this job

statusenum

Job lifecycle states:

OPEN - Job created and accepting documents
UPLOAD_COMPLETE - All documents have been received, and processing has not yet started
IN_PROGRESS - Documents are being processed (AI extraction)
COMPLETE - The full e2e process is complete
FAILED - System error prevented job execution
CANCELED - User initiated request to cancel a job

status_enumlist of strings

created_atstringformat: "date-time"

modified_atstringformat: "date-time"

expires_atstringformat: "date-time"

metadataobject

Properties about THIS request/response, not the job resource itself

external_job_idstringOptionalformat: "uuid"

User provided reference ID for this job

ttl_periodstringOptional

ISO 8601 duration for job validity

upload_settingsobjectOptional

Upload configuration settings for the bulk job

ai_processingobjectOptional

AI processing status for BULK_API_INGESTION jobs. Always present; resume_ai_triggered_at is set only for jobs where resume-AI processing was triggered.

summaryobjectOptional

Aggregate document counts. Always present in the job status response alongside _embedded.documents (when include_document_details=true) or as the sole count source (when false).

_embeddedobjectOptional

Contains detailed information about the BulkJob including presigned upload links, document IDs, etc

_action_templatesobjectOptional

_linksobjectOptional

constraintsobjectOptional

Describes the limits of a bulk job, or an action associated with a bulk job

messagestringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error