> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer.deel.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server. # Accept amendment POST https://api.letsdeel.com/rest/eor/contracts/{contract_id}/amendments/{amendment_id}/accept Content-Type: application/json Accepts a pending amendment on an EOR worker contract, formally approving the proposed modifications on the client's behalf. The amendment must already exist and be in a pending state before this operation can be called. **Token scopes**: `contracts:write` Reference: https://developer.deel.com/api/eor-endpoints/eor-amendments/accept-contract-amendment ## Authentication - `Authorization` header (bearer token, required) — ## 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) - `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/ ## Servers - `https://api.letsdeel.com/rest` (Production, default) - `https://api-staging.letsdeel.com/rest` (Demo) ## Request ### Path parameters - `contract_id` (string, required) — The unique identifier of EOR worker contract. - `amendment_id` (string, required) — A unique identifier for the employee contract amendment. ## Response ### 200 Amendment info - `data` (EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaData, optional) ## Errors ### 400 Bad Request Error Bad Request. The request could not be understood or was missing required parameters. - `errors` (list of EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 401 Unauthorized Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ### 403 Forbidden Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ### 404 Not Found Error Resource not found (e.g., contract, profile, amendment, change request). - `errors` (list of EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 500 Internal Server Error Internal server error. - `errors` (list of EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaErrorsItems, required) ## Types ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaData - `id` (string, optional) — Id of amendment - `type` (enum, optional, nullable) — Type of amendment - Allowed values: `INSTANT`, `OPS`, `LEGAL`, `DISABLED`, `CUSTOM`, `AUTOMATED` - `items` (list of EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataItemsItems, optional) — Items of amendment - `scope` (string, optional) — Scope of the amendment. - `salary` (string, optional) — Salary for the amendment. - `source` (enum, optional, nullable) — Source of amendment flow creation. - Allowed values: `APP`, `PUBLIC_API`, `APP_BULK_AMENDMENT` - `currency` (string, optional) — Contract currency. - `end_date` (string, optional, nullable) — End date of the employment. - `holidays` (integer, optional, nullable) — Number of holidays. - `job_code` (string, optional, nullable) — Job code associated with the job title. - `job_title` (string, optional) — Job title associated with the amendment. - `created_at` (string, optional) — Creation date of the amendment. - `net_salary` (string, optional, nullable) — Net salary for the amendment. - `start_date` (string, optional) — Start date of the employment. - `updated_at` (string, optional) — Date when amendment is updated - `description` (string, optional, nullable) — Free-text description of the amendment. - `hourly_rate` (string, optional, nullable) — Hourly rate of the amendment - `custom_items` (list of EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataCustomItemsItems, optional) — Custom amendment items associated with the amendment flow - `job_category` (string, optional, nullable) — Job category associated with the job title. - `requested_by` (string, optional, nullable) — Profile name of the user who requested the change - `seniority_id` (string, optional, nullable) — Seniority level identifier. - `document_type` (enum, optional, nullable) — Amendment document type - Allowed values: `EA`, `SOW`, `SOW_EA` - `legal_context` (EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataLegalContext, optional, nullable) — Additional details needed for legal input - `time_off_type` (enum, optional) — Type of time off. - Allowed values: `STANDARD`, `SPECIFIC`, `PRORATED` - `void_deadline` (string, optional, nullable) — Deadline this SOW to be voided - `effective_date` (string, optional, nullable) — Effective date of the amendment. - `seniority_date` (string, optional, nullable) — The seniority date represents the employee’s original start date with a previous employer. It is used to preserve employment tenure when the employee transfers to this company. Can be null if not applicable. - `employment_type` (enum, optional) — Type of employment. - Allowed values: `FULL_TIME`, `PART_TIME` - `sick_leave_days` (integer, optional, nullable) — Number of sick leave days - `employment_state` (string, optional, nullable) — State of employment. - `probation_period` (integer, optional, nullable) — Duration of the probation period. - `work_schedule_id` (string, optional, nullable) — Work schedule id - `fixed_adjustments` (list of EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataFixedAdjustmentsItems, optional) — List of fixed adjustments associated with the amendment request. - `rejection_context` (EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataRejectionContext, optional, nullable) — Additional details containing rejection reason - `amendment_statuses` (list of EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataAmendmentStatusesItems, optional) — List of amendment statuses representing the history and progression of an amendment. - `notice_period_type` (enum, optional, nullable) — Type of notice period. - Allowed values: `STANDARD`, `CUSTOM` - `void_deadline_type` (enum, optional, nullable) — Type of void deadline - Allowed values: `CUTOFF`, `START_DATE`, `END_DATE`, `EXPIRY` - `work_hours_per_week` (string, optional) — Number of work hours per week. - `employee_nationality` (string, optional) — Nationality of the employee. - `is_hrx_action_needed` (boolean, optional) — Is HRX action needed. - `variable_compensation` (EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataVariableCompensation, optional) — Represents a variable compensation record (such as a bonus, commission, or incentive) within a contract. It contains details like the amount, type, frequency, and whether it is part of an incentive plan. The record also tracks when it was created, updated, and whether it has been amended. - `notice_period_time_unit` (enum, optional, nullable) — Notice period time unit. - Allowed values: `DAY`, `WEEK`, `MONTH` - `is_effective_date_updated` (boolean, optional) — Is Effective Date updated. - `work_schedule_rules_version` (string, optional, nullable) — Work schedule rule version. - `notice_period_after_probation` (string, optional, nullable) — Notice period after probation. - `notice_period_during_probation` (string, optional, nullable) — Notice period during probation. - `probation_period_type_for_definite` (enum, optional, nullable) — Type of probation period for definite contracts. - Allowed values: `STANDARD`, `CUSTOM` ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaErrorsItems - `code` (string, required) - `message` (string, required) ### ApiErrorRequest - `method` (string, optional) — The HTTP method of the failed request - `url` (string, optional) — The relative URL of the failed request - `status` (double, optional) — The status code of the response - `api_req_id` (string, optional) — The request ID of the failed request - `docs` (string, optional) — A link to the official documentation for the requested endpoint resource - `source` (string, optional) — The source handler which produced the returned error - `code` (double, optional) — The code of the source handler which produced the returned error ### ApiError - `message` (string, optional) — A description of the returned error - `path` (string, optional) — The JSON path where input validation failed ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataItemsItems - `id` (string, optional) — Id of amendment item - `item` (string, optional) — Amendment item - `type` (enum, optional) — Type of amendment - Allowed values: `INSTANT`, `OPS`, `LEGAL`, `DISABLED`, `CUSTOM`, `AUTOMATED` - `new_value` (string, optional) — The new valid value after the attempted change. - `data_point` (string, optional) — The field that is selected for amendment. - `previous_value` (string, optional) — The previous valid value before the attempted change. ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataCustomItemsItems - `id` (string, required) — Unique identifier for the custom amendment item - `type` (string, required) — Type/context of the custom amendment item - `status` (enum, required) — Current status of the custom amendment item - Allowed values: `REJECTED`, `APPROVED`, `PENDING_REVIEW`, `PENDING_LEGAL` - `description` (string, optional, nullable) — Detailed description of the custom amendment item - `rejection_reason` (string, optional, nullable) — Reason for rejection if the item was rejected ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataLegalContext Additional details needed for legal input - `status` (enum, optional) — Current status of the legal review process - Allowed values: `REQUEST_LEGAL_REVIEW`, `WAITING_FOR_ANOTHER_TEAM`, `WAITING_FOR_HRX_ACTION`, `DECLINED`, `SOLVED` - `details` (string, optional) — Details regarding the legal request - `jira_ticket` (string, optional) — Jira ticket identifier linked to the legal context - `jira_web_url` (string, optional) — Link to the Jira ticket for tracking - `requested_at` (string, optional) — Timestamp when legal review was requested ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataFixedAdjustmentsItems - `id` (string, required) — System-generated unique identifier for the fixed adjustment record in an amendment request. - `value` (string, required) — Value of the fixed adjustment. - `status` (enum, required) — Current status of the fixed adjustment. - Allowed values: `WAITING_FOR_SIGNING`, `ACTIVE`, `OUTDATED`, `CANCELLED` - `created_at` (string, required) — Timestamp when the fixed adjustment was created. - `is_amended` (boolean, required) — Whether this fixed adjustment was amended from a previous one. - `updated_at` (string, required) — Timestamp when the fixed adjustment was last updated. - `description` (string, required) — Description of the fixed adjustment. - `is_recurring` (boolean, required) — Whether the fixed adjustment is recurring. If set to false, it will be treated as a one-time fixed allowance. - `is_country_specific` (boolean, required) — Whether this fixed adjustment applies only to a specific country. - `is_deleted` (boolean, optional) — True if the fixed adjustment was deleted as part of the amendment; otherwise false. - `parent_fixed_adjustment_id` (string, optional, nullable) — Reference to the parent fixed adjustment, if applicable. ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataRejectionContext Additional details containing rejection reason - `rejected_at` (string, optional) — Timestamp of when the rejection occurred - `rejection_reason` (string, optional, nullable) — Reason provided when the amendment was rejected. Null when the amendment was cancelled rather than rejected by an admin. ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataAmendmentStatusesItems Details of a specific amendment status in the lifecycle of the amendment. - `name` (string, optional) — Logical, system-oriented identifier of the amendment status. Can be used to group statuses under a parent category and subgroup them for more granular state tracking. The structure typically follows a dot-separated hierarchy (e.g., 'PARENT','PARENT.CHILD', 'PARENT.CHILD.CHILD.CHILD', ...), which allows logical grouping and filtering of related statuses. - `friendly_name` (string, optional) — Human-readable label of the amendment status (e.g., DRAFT, PENDING, APPROVED). - `amendment_flow_status` (EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataAmendmentStatusesItemsAmendmentFlowStatus, optional) — Metadata about the amendment status, including when it was created. ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataVariableCompensation Represents a variable compensation record (such as a bonus, commission, or incentive) within a contract. It contains details like the amount, type, frequency, and whether it is part of an incentive plan. The record also tracks when it was created, updated, and whether it has been amended. - `id` (string, required) — The unique ID assigned by the system to this variable compensation record. - `type` (enum, required) — The way the compensation is calculated. `FIXED` means a fixed amount (like $1000). `PERCENTAGE` means it’s based on a percentage of the salary. - Allowed values: `FIXED`, `PERCENTAGE` - `title` (string, required) — Title or name of the variable compensation. - `amount` (string, required) — The value of the compensation. Shown as a string to keep the exact number of decimals. - `timeline` (enum, required) — How often the compensation is paid — for example monthly, quarterly, annually, or twice a year. - Allowed values: `MONTHLY`, `QUARTERLY`, `ANNUALLY`, `BIANNUALLY` - `parent_id` (string, required, nullable) — Reference to the parent variable compensation, if applicable. Null if this compensation is not linked to any compensation. - `created_at` (string, required) — The date and time when this record was first created in the system. - `updated_at` (string, required) — The date and time when this record was last updated. - `effective_date` (string, required) — The date when this compensation starts being valid. - `is_amended` (boolean, optional) — Shows whether this compensation has been changed as part of an amendment. - `is_deleted` (boolean, optional) — Shows whether this compensation has been deleted. - `incentive_plan` (EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataVariableCompensationIncentivePlan, optional) — Details of the incentive plan linked to this compensation, if any. ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataAmendmentStatusesItemsAmendmentFlowStatus Metadata about the amendment status, including when it was created. - `created_at` (string, optional) — The timestamp when this amendment status was created. ### EorContractsContractIdAmendmentsAmendmentIdAcceptPostResponsesContentApplicationJsonSchemaDataVariableCompensationIncentivePlan Details of the incentive plan linked to this compensation, if any. - `details` (string, optional) — Extra details about the incentive plan, if any. - `employee_signature` (string, optional) — The employee’s signature for the incentive plan, if collected. - `employee_signed_at` (string, optional) — The date and time when the employee signed the incentive plan. Empty if not signed. ## Examples **Request** ```json {} ``` **Response** ```json { "data": { "id": "b9fd7198-7e81-4e57-bcf9-de6315194327", "type": "OPS", "items": [ { "id": "8e6ba281-c703-4af3-ad93-b27434b70c7d", "item": "SALARY_INCREASE", "type": "OPS", "new_value": "62382.93", "data_point": "salary", "previous_value": "68.9170" } ], "scope": "Project scope details", "salary": "50000.00", "source": "APP", "currency": "GBP", "end_date": "2023-10-04T13:27:20.148Z", "holidays": 20, "job_code": "49589", "job_title": "Software Engineer", "created_at": "2023-10-04T13:27:20.148Z", "net_salary": "95000.0000", "start_date": "2023-10-04T13:27:20.148Z", "updated_at": "2023-10-04T13:27:20.148Z", "description": "Reason or note for the amendment.", "hourly_rate": "50000.00", "custom_items": [ { "id": "e7b45fa6-9a72-4ab6-b163-ef50ccaba7fb", "type": "START_DATE", "status": "PENDING_REVIEW", "description": "Please change the start date to 20th November 2025.", "rejection_reason": "Start date cannot be moved this far in advance." } ], "job_category": "Engineering", "requested_by": "John Doe", "seniority_id": "550e8400-e29b-41d4-a716-446655440000", "document_type": "SOW_EA", "legal_context": { "status": "REQUEST_LEGAL_REVIEW", "details": "This amendment requires input from the legal team and will be moved to `paused` until it is resolved manually", "jira_ticket": "COHDSB-9600", "jira_web_url": "https://letsdeel.atlassian.net/browse/COHDSB-9600", "requested_at": "2025-04-23T10:40:25.527Z" }, "time_off_type": "STANDARD", "void_deadline": "2023-01-01T00:00:00Z", "effective_date": "2023-01-01T00:00:00Z", "seniority_date": "2023-01-01", "employment_type": "FULL_TIME", "sick_leave_days": 12, "employment_state": "Active", "probation_period": 3, "work_schedule_id": "2b786de3-9b25-42d9-8a2d-61583bcfc09e", "fixed_adjustments": [ { "id": "cmfo0hqd5bw00cqs1b1jd7eag", "value": "1200.50", "status": "WAITING_FOR_SIGNING", "created_at": "2025-09-22T10:21:13.815Z", "is_amended": true, "updated_at": "2025-09-22T10:21:13.815Z", "description": "Housing allowance for employee relocation", "is_recurring": true, "is_country_specific": false, "is_deleted": false, "parent_fixed_adjustment_id": "cmfo0hqd5i9kbhfvk8fn7aniy" } ], "rejection_context": { "rejected_at": "2025-02-24T11:08:57.433Z", "rejection_reason": "Client requested a different start date." }, "amendment_statuses": [ { "name": "PREPARING_DOCUMENTS.AMENDMENT_REQUESTED.SOW.PENDING_DOCUMENT_SUBMIT", "friendly_name": "AWAITING_REVIEW", "amendment_flow_status": { "created_at": "2023-10-04T13:27:20.148Z" } } ], "notice_period_type": "CUSTOM", "void_deadline_type": "CUTOFF", "work_hours_per_week": "40.00", "employee_nationality": "GB", "is_hrx_action_needed": false, "variable_compensation": { "id": "cmg0p4zgszy3m8v3a04bd5sjs", "type": "FIXED", "title": "Bonus", "amount": "100000.0000", "timeline": "ANNUALLY", "parent_id": "cmg0p4zgszy3m8v3a04bd5sjs", "created_at": "2025-09-26T10:25:50.476Z", "updated_at": "2025-09-26T10:25:50.476Z", "effective_date": "2025-10-18T00:00:00.000Z", "is_amended": true, "is_deleted": true, "incentive_plan": { "details": "Year-end performance bonus based on quarterly targets.", "employee_signature": "John Doe", "employee_signed_at": "2025-12-15T14:30:00.000Z" } }, "notice_period_time_unit": "WEEK", "is_effective_date_updated": false, "work_schedule_rules_version": "2", "notice_period_after_probation": "30", "notice_period_during_probation": "15", "probation_period_type_for_definite": "STANDARD" } } ``` **SDK Code** ```python eor-amendments_acceptContractAmendment_example import requests url = "https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept" payload = {} headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript eor-amendments_acceptContractAmendment_example const url = 'https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go eor-amendments_acceptContractAmendment_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept" payload := strings.NewReader("{}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby eor-amendments_acceptContractAmendment_example require 'uri' require 'net/http' url = URI("https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java eor-amendments_acceptContractAmendment_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php eor-amendments_acceptContractAmendment_example request('POST', 'https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept', [ 'body' => '{}', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp eor-amendments_acceptContractAmendment_example using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift eor-amendments_acceptContractAmendment_example import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/eor/contracts/3w6pd6r/amendments/77733bb9-9e17-4dfd-ba1b-1315f77cd7f7/accept")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```