Assign agreement to a new worker

POST

/it/agreements/:agreement_id/reassign

POST

/rest/it/agreements/:agreement_id/reassign

$ curl -X POST https://api.letsdeel.com/rest/it/agreements/3b1a0000-0000-0000-0000-000000000000/reassign \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "data": {
>     "variant_id": "2f4e7ab1-9d3c-4b1f-9e34-6dfb0d6a12ab",
>     "hris_profile_id": "6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71",
>     "delivery_address": {
>       "country": "GB"
>     }
>   }
> }'

1 {
2   "data": {
3     "id": "3b1a0000-0000-0000-0000-000000000000",
4     "type": "RENTAL",
5     "status": "ACTIVE",
6     "actions": {
7       "reuse": {
8         "details": {
9           "reassignable_in": [
10             "GB",
11             "IE",
12             "FR",
13             "DE"
14           ],
15           "reusable_variants": [
16             {
17               "id": "2f4e7ab1-9d3c-4b1f-9e34-6dfb0d6a12ab",
18               "sku": "MBP16-M3P-SPACE-UK",
19               "size": "16-inch",
20               "image": {
21                 "id": "b1c3d5e7-8a9b-4c2d-9e0f-1a2b3c4d5e6f",
22                 "url": "https://cdn.deel.com/products/mbp16-space-black.png"
23               },
24               "style": "Space Black",
25               "public_id": "VAR-2f4e",
26               "keyboard_layout": "UK_ENGLISH_QWERTY",
27               "operating_system": "MACOS",
28               "available_countries": [
29                 "AD"
30               ],
31               "allowed_rental_terms": [
32                 "MONTH_12"
33               ],
34               "allowed_acquisition_types": [
35                 "PURCHASE"
36               ]
37             }
38           ]
39         },
40         "is_enabled": true,
41         "disabled_reason": "CONTRACT_IS_NOT_REUSE_ENABLED"
42       }
43     },
44     "product": {
45       "id": "550e8400-e29b-41d4-a716-446655440000",
46       "name": "MacBook Pro",
47       "brand": "Apple",
48       "category": "LAPTOP"
49     },
50     "end_date": "2026-11-15",
51     "public_id": "CTR-3b1a",
52     "created_at": "2024-11-01T09:00:00Z",
53     "start_date": "2024-11-15",
54     "updated_at": "2026-07-14T10:00:00Z",
55     "variant_id": "2f4e7ab1-9d3c-4b1f-9e34-6dfb0d6a12ab",
56     "store_and_reuse": {
57       "status": "READY"
58     },
59     "billing_entity_id": "550e8400-e29b-41d4-a716-446655440000",
60     "assigned_hris_profile": {
61       "emails": [
62         "bruce.wayne@wayne-enterprise.com",
63         "batman@gotham.com"
64       ],
65       "address": {
66         "id": "550e8400-e29b-41d4-a716-446655440000",
67         "city": "Gotham",
68         "type": "DELIVERY",
69         "line1": "1007 Mountain Drive",
70         "line2": "Stately Wayne Manor",
71         "state": "New Jersey",
72         "country": "US",
73         "is_valid": true,
74         "post_code": "12345",
75         "phone_number": "+1-212-456-7890",
76         "date_of_birth": "1997-12-18",
77         "tax_id_number": "BAT123456",
78         "passport_number": "P123456789",
79         "delivery_instructions": "Use the Bat-Signal if urgent"
80       },
81       "last_name": "Wayne",
82       "first_name": "Bruce",
83       "hris_profile_id": "550e8400-e29b-41d4-a716-446655440000"
84     }
85   }
86 }

Use this when a worker leaves and their rented device should pass to a new joiner rather than return to Deel. Reassigns a rental agreement to a new HRIS profile via store-and-reuse. The caller picks a variant_id from actions.reuse.details.reusable_variants on GET /rest/it/agreements/{agreement_id} and supplies the new holder’s delivery address. Transitions store_and_reuse.status from READY to IN_PROGRESS and returns the updated agreement.

Token scopes: it-service-requests:write

Use this when a worker leaves and their rented device should pass to a new joiner rather than return to Deel. Reassigns a rental agreement to a new HRIS profile via store-and-reuse. The caller picks a `variant_id` from `actions.reuse.details.reusable_variants` on `GET /rest/it/agreements/{agreement_id}` and supplies the new holder's delivery address. Transitions `store_and_reuse.status` from `READY` to `IN_PROGRESS` and returns the updated agreement. **Token scopes**: `it-service-requests: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

agreement_idstringRequiredformat: "uuid"

Unique identifier of the agreement

Request

Reassignment details

dataobjectRequired

Reassignment payload.

Response

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 GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'