Set the tags of a candidate
Replaces the full set of tags on a candidate, removing any tag that is not sent. Use it to sync a candidate’s labels from another system after finding tag ids with GET /rest/ats/tags or creating them with POST /rest/ats/upsertions/bulk-tags. This action is reversible: removed tags can be set again with this same endpoint.
Token scopes: ats:write, 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.letsdeel.com/rest/v2/contracts' \
-H 'Authorization: Bearer YOUR-TOKEN-HERE'
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/
Path parameters
Headers
Version of this endpoint to call (YYYY-MM-DD). This reference documents version 2026-08-10. When the header is omitted the API serves the oldest version that is neither beta nor sunset, which can be an older version with a different contract than the one documented here.
Request
Response
List of created candidate-tag associations.