Update a US tax form for the authenticated worker
This endpoint replaces/updates the authenticated worker’s US tax form (W-8/W-9) with a corrected version, such as one that fixes a mistyped tax ID, legal name, or address.
The worker is identified from the access token, so ONLY their own forms can be replaced.
Send the complete form: any optional field you omit is cleared.
The exception is contractor_signature, which keeps the signature on file if you omit it and is required when the stored form has no signature.
client_legal_entity_id is not accepted, because the legal entity is part of the form’s uniqueness key and can’t be reassigned.
The worker must have an active (non-terminated) contract with the form’s legal entity.
Please note: You can edit a tax form whose 1099 has already been filed with the IRS, but this operation does not refile the 1099 with the corrected form.
Token scopes: worker:write
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 -X GET 'https://api.deel.training/rest/v2/contracts' \
-H 'Authorization: Bearer YOUR-TOKEN-HERE'
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/
Path parameters
Public ID (UUID) of the tax form to replace, as returned by the create or list endpoints.