
Deel Documents Download
CertifiedDownload EOR Contract Document
Deel Documents Download
Download EOR Contract Document
Download an HRX document for an EOR contract. The API returns a pre-signed URL; the file content is stored in Kestra storage. Requires the contracts: read and worker: read scopes.
type: io.kestra.plugin.deel.documents.DownloadExamples
Download a contract document
id: download_document
namespace: company.team
tasks:
- id: download_document
type: io.kestra.plugin.deel.documents.Download
apiToken: "{{ secret('DEEL_API_TOKEN') }}"
contractId: "123E4567"
documentId: "123e4567-e89b-12d3-a456-426614174000"
Installation
Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:
kestractl plugins get io.kestra.plugin:plugin-deel --compatible-for $KESTRA_VERSION For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.
For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.
Properties
apiToken *string
Deel API token
API token for authentication. Can be an organization token, personal token, or worker token.
contractId *string
Contract ID
The unique identifier of the EOR employee contract.
documentId *string
Document ID
The unique identifier of the document to download.
apiVersion string
2026-01-01API version
API version header value. Defaults to 2026-01-01.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://api.letsdeel.com/restDeel API base URL
Base URL for the Deel API. Use https://api-sandbox.demo.deel.com/rest for sandbox environment.
Outputs
contractId string
Contract ID
The EOR contract the document belongs to.
documentId string
Document ID
The downloaded document.
size integer
File size in bytes
Size of the downloaded file.
uri string
uriStored document URI
Kestra internal storage path to the downloaded file.