Update Legal Entity Registration Document Files | Deel

curl -X PUT https://api.letsdeel.com/rest/legal-entities/c106a26a-21bb-5538-8bf2-57095d1976c1/registration-documents/c106a26a-21bb-5538-8bf2-57095d1976c1 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": {
    "files": [
      {
        "file_id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
        "content_type": "application/pdf",
        "one_time_secret": "a1b2c3d4e5f6",
        "original_filename": "certificate_of_incorporation.pdf"
      }
    ]
  }
}'

{
  "data": {
    "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
    "status": "AWAITING_REVIEW",
    "files": [
      {
        "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
        "original_filename": "certificate_of_incorporation.pdf",
        "uploaded_at": "2026-08-17T09:30:00.000Z",
        "content_type": "application/pdf"
      }
    ],
    "parent": {
      "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
      "status": "REJECTED"
    },
    "children": [
      {
        "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
        "status": "AWAITING_REVIEW",
        "files": [
          {
            "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
            "original_filename": "certificate_of_incorporation.pdf",
            "uploaded_at": "2026-08-17T09:30:00.000Z",
            "content_type": "application/pdf"
          }
        ],
        "archived_at": "2026-09-01T08:00:00.000Z",
        "reviewed_at": "2026-08-18T11:00:00.000Z",
        "submitted_at": "2026-08-17T09:30:00.000Z",
        "rejection_reason": "Document is illegible"
      }
    ],
    "archived_at": "2026-09-01T08:00:00.000Z",
    "requirement": {
      "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
      "name": "Certificate of Incorporation",
      "description": "A copy of the certificate issued at registration.",
      "is_disabled": false,
      "has_template": false,
      "product_type": "GLOBAL_PAYROLL",
      "applicable_at": "BEFORE_FIRST_PAYROLL",
      "reference_url": "https://example.gov/certificates",
      "is_approval_required": true,
      "is_submission_required": true,
      "how_the_document_is_used": "PAYROLL_PURPOSE",
      "why_the_document_is_needed": "Required to register the entity for payroll.",
      "how_client_obtains_document": "Download it from the companies registry."
    },
    "reviewed_at": "2026-08-18T11:00:00.000Z",
    "legal_entity": {
      "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
      "name": "Acme BV",
      "country": "NL"
    },
    "submitted_at": "2026-08-17T09:30:00.000Z",
    "rejection_reason": "Document is illegible",
    "submission_due_date": "2026-09-30T00:00:00.000Z",
    "archived_submissions_count": 2
  }
}

Replaces the files on a legal entity document with newly uploaded ones, typically after the document was rejected. The previous submission is archived rather than deleted, so the review history is preserved, and a new submission id is returned. Use the add-files endpoint instead when attaching a missing page to a document that is still under review.

Token scopes: legal-entity:write

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

legal_entity_idstringRequiredformat: "uuid"

Public UUID of the legal entity.

document_idstringRequiredformat: "uuid"

Public UUID of the document submission.

Request

This endpoint expects an object.

dataobjectRequired

Response

Document resubmitted successfully.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error