Update a tax form for the authenticated worker

PUT

/workers/tax-forms/:tax_form_id

Replace the authenticated worker’s existing tax form with a corrected version, for example to fix a mistyped tax identification number, legal name or address. The worker is resolved from the access token and only their own forms are addressable. The body is the complete form rather than a partial update: an optional field left out is cleared, except contractor_signature, which keeps the value already on file when omitted — it must be supplied when the stored form carries no signature. client_legal_entity_id is not accepted — the legal entity is part of the form’s uniqueness key and can never be reassigned. The worker must have an active (non-terminated) contract with the form’s legal entity. Editing a form whose 1099 has already been filed with the IRS is permitted but does not refile it.

Token scopes: worker:write

Replace the authenticated worker's existing tax form with a corrected version, for example to fix a mistyped tax identification number, legal name or address. The worker is resolved from the access token and only their own forms are addressable. The body is the complete form rather than a partial update: an optional field left out is cleared, except contractor_signature, which keeps the value already on file when omitted — it must be supplied when the stored form carries no signature. client_legal_entity_id is not accepted — the legal entity is part of the form's uniqueness key and can never be reassigned. The worker must have an active (non-terminated) contract with the form's legal entity. Editing a form whose 1099 has already been filed with the IRS is permitted but does not refile it. **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.letsdeel.com/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.letsdeel.com/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

tax_form_idstringRequiredformat: "uuid"

Public ID (UUID) of the tax form to replace, as returned by the create or list endpoints.

Request

This endpoint expects an object.

dataobjectRequired

Response

Tax form replaced successfully.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

$	curl -X PUT https://api.letsdeel.com/rest/workers/tax-forms/00000000-0000-0000-0000-000000000000 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"data": {
>	"city": "New York",
>	"address": "123 Main Street",
>	"country": "US",
>	"zip_code": "10001",
>	"form_type": "W9_INDIVIDUAL",
>	"last_name": "Doe",
>	"first_name": "John",
>	"tax_number": {
>	"type": "SSN",
>	"value": "219-09-9999"
>	}
>	}
>	}'

1	{
2	"data": {
3	"id": "00000000-0000-0000-0000-000000000000",
4	"created_at": "2026-01-15T12:00:00.000Z",
5	"updated_at": "2026-01-15T12:00:00.000Z"
6	}
7	}

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