Submit files for one compliance document of a worker contract

POST

/workers/contracts/:contract_id/compliance-documents/:document_id

Submits one or more files against a compliance document of one of the authenticated worker Global Payroll contracts. Upload the bytes to the File Service first, then reference each file here by file_id and its one_time_secret; the Files endpoints of this API issue both. Side effects: the files replace whatever was previously submitted against the requirement, and the previous version is archived when document versioning is enabled for the organization. Only Global Payroll contracts are supported.

Token scopes: worker:write

Submits one or more files against a compliance document of one of the authenticated worker Global Payroll contracts. Upload the bytes to the File Service first, then reference each file here by `file_id` and its `one_time_secret`; the Files endpoints of this API issue both. Side effects: the files replace whatever was previously submitted against the requirement, and the previous version is archived when document versioning is enabled for the organization. Only Global Payroll contracts are supported. **Token scopes**: `worker: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.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## 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 curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

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

Path parameters

contract_idstringRequired1-64 characters

Public id of the Global Payroll contract the documents belong to.

document_idstringRequiredformat: "uuid"

Public UUID of the compliance document requirement, as returned in id by the list endpoint.

Request

This endpoint expects an object.

dataobjectRequired

Response

Files submitted successfully. No response body — read the document back through the list or the single document endpoint to confirm the filenames, where submission_status can read REVIEWING until the submission is final.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

412

Precondition Failed Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

$	curl -X POST https://api.letsdeel.com/rest/workers/contracts/37nex2x/compliance-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": "example-one-time-secret-value",
>	"original_filename": "passport_scan.pdf"
>	}
>	]
>	}
>	}'

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'