Skip to content

Deel: Update EOR Contract

Deel eorContract.updateEorcontract: arguments, response, policy and SDK examples.

← EOR contract operations · Get started

Operation deel.eorcontract_updateeorcontract

Provider route: PATCH /eor/contract/{contract_id}. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/deel with npm, or alter-sdk-deel with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { DeelIntegration } from "@alter-ai/deel";
async function execute(input: Parameters<DeelIntegration["eorContract"]["updateEorcontract"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new DeelIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.eorContract.updateEorcontract(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_deel import DeelIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = DeelIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.eor_contract.update_eorcontract(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.contract_idstringRequired within parent
bodyobjectOptional
body.dataModelRequired within parentExpand Update EOR Contract — request body — body data

Referenced models: Update EOR Contract — request body — body data

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$ModelRootExpand Update EOR Contract — 200 response body

Referenced models: Update EOR Contract — 200 response body

1 more schema is linked from the tables above, on the schema pages.

Update EOR Contract — request body — body data
FieldTypePresenceDescription and constraints
$objectRoot
allow_consultant_equipment_reimbursementbooleanOptionalAllow equipment reimbursement for consultants
benefitsarray or nullOptionalArray of employee benefits
benefits[]ModelEach itemExpand Update EOR Contract — request body — body data benefits item
contract_term_typestringOptionalType of contract term
One of: DEFINITE, INDEFINITE
currencystringOptionalCurrency code for salary and benefits
employee_addressModelOptionalExpand Update EOR Contract — request body — body data employee address
Employee's address information
employee_emailstringRequired within parentEmployee's email address
Format: email
employee_first_namestringRequired within parentEmployee's first name
employee_idstringOptionalEmployee's unique identifier
employee_last_namestringRequired within parentEmployee's last name
employee_nationalitystringOptionalEmployee's nationality
employment_countrystringRequired within parentCountry of employment
employment_statestring or nullOptionalState/Province of employment
employment_typestringRequired within parentType of employment
One of: Full-time, Part-time
end_datestring or nullOptionalEmployment end date
Format: date
hiring_objectivestringOptionalObjective for hiring
One of: EXPANDING_TO_NEW_COUNTRY, TEMP_EOR_OPENING_ENTITY, ONE_OFF_HIRE, CONVERTING_CONTRACTOR, OTHER
hiring_objective_extra_infostring or nullOptionalAdditional information about hiring objective
holidaysnumber or nullOptionalNumber of holiday days per year
Format: double
Minimum: 0
hourly_ratestring or nullOptionalHourly rate. Required when is_hourly is true. Must not be sent when is_hourly is false or omitted.
is_auto_quote_validation_passedboolean or nullOptionalAuto quote validation status
is_hourlyboolean or nullOptionalIndicates if compensation is hourly
is_resubmitboolean or nullOptionalIndicates if this is a resubmission
job_titlestringRequired within parentJob title (cannot be C-level position)
medical_insurancebooleanOptionalMedical insurance coverage
notice_period_after_probationnumberOptionalNotice period after probation (days)
Format: double
Minimum: 0
notice_period_during_probationnumberOptionalNotice period during probation (days)
Format: double
Minimum: 0
notice_period_typestringOptionalType of notice period
One of: STANDARD, CUSTOM
probation_periodnumber or nullOptionalProbation period duration
Format: double
Minimum: 0
probation_period_type_for_definitestringOptionalUnit of time for probation period
One of: CUSTOM, STANDARD
quote_additional_fieldsModelOptionalExpand Update EOR Contract — request body — body data quote additional fields
Additional quote-specific information
reason_for_fixed_termJSONOptionalReason for fixed-term contract
reason_for_fixed_term (oneOf 1)stringAlternativeReason for fixed-term contract
One of: SEASONAL_OR_TEMPORARY_WORK, PROJECT_BASED_EMPLOYMENT, REPLACEMENT_FOR_PERMANENT_STAFF, TRIAL_PERIODS_FOR_NEW_ROLES_OR_BUSINESSES
reason_for_fixed_term (oneOf 2)nullAlternative
salarystringOptionalAnnual salary amount. Optional; must not be sent when is_hourly is true.
schedule_idstring or nullOptionalUnique identifier for the employee's work schedule
scopeModelOptionalExpand Update EOR Contract — request body — body data scope
Scope of work description, either as a plain string or as a reference to a scope template.
seniority_datestringOptionalEmployee seniority date
Format: date
seniority_idnumberOptionalSeniority level identifier
Format: double
sick_leave_daysnumber or nullOptionalNumber of sick leave days per year
Format: double
Maximum: 90
Minimum: 0
signing_bonusstring or nullOptionalSigning bonus amount
signing_bonus_payout_typeJSONOptionalDetermines when the signing bonus will be paid out
Default: FIRST_CYCLE
signing_bonus_payout_type (oneOf 1)stringAlternativeDetermines when the signing bonus will be paid out
Default: FIRST_CYCLE
One of: FIRST_CYCLE, AFTER_PROBATION, AFTER_FIRST_CONTRACT_ANNIVERSARY
signing_bonus_payout_type (oneOf 2)nullAlternative
start_datestringRequired within parentEmployment start date
Format: date
time_off_typestringOptionalType of time off
One of: STANDARD, SPECIFIC, PRORATED
work_arrangementJSONOptionalWork arrangement type
work_arrangement (oneOf 1)stringAlternativeWork arrangement type
One of: REMOTE, ON_SITE_OR_HYBRID
work_arrangement (oneOf 2)nullAlternative
work_eligibilityModelOptionalExpand Update EOR Contract — request body — body data work eligibility
Work eligibility documentation
work_hours_per_weeknumberOptionalWorking hours per week
Format: double
Maximum: 168
Minimum: 0
work_pensionboolean or nullOptionalIndicates if work pension is included
work_visaboolean or nullOptionalIndicates if work visa is required

Referenced models: Update EOR Contract — request body — body data benefits item, Update EOR Contract — request body — body data employee address, Update EOR Contract — request body — body data quote additional fields, Update EOR Contract — request body — body data scope, Update EOR Contract — request body — body data work eligibility

Update EOR Contract — 200 response body
FieldTypePresenceDescription and constraints
$objectRoot
oidstringRequired within parentThe unique identifier of the employee contract.
scope_of_workstringOptionalScope of work description.
statusstringRequired within parentCurrent status of the contract
Known values: new, under_review, waiting_for_client_sign, waiting_for_eor_sign, waiting_for_employee_sign, awaiting_deposit_payment, rejected
Update EOR Contract — request body — body data benefits item
FieldTypePresenceDescription and constraints
$objectRootBenefit plan details
contributionnumber or nullOptionalContribution amount
Format: double
Maximum: 9999999999999
Minimum: 0
cover_allbooleanOptionalIndicates if benefit covers all
cover_dependentsbooleanOptionalIndicates if benefit covers dependents
plan_idstring or nullOptionalBenefit plan ID
provider_idstring or nullOptionalBenefit provider ID
Update EOR Contract — request body — body data employee address
FieldTypePresenceDescription and constraints
$objectRootEmployee's address information
calling_codestringOptionalCountry calling code
citystringRequired within parentCity of residence
countrystringRequired within parentCountry of residence (can be country code or name)
phonestringOptionalPhone number
provincestringOptionalProvince of residence
statestringOptionalState of residence
streetstringRequired within parentStreet address
zipstringOptionalZIP/Postal code
Update EOR Contract — request body — body data quote additional fields
FieldTypePresenceDescription and constraints
$objectRootAdditional quote-specific information
employee_typestringOptionalType of employee
One of: Employee, Manager
qualificationsstringOptionalRequired qualifications
qualifications_german_translationstringOptionalGerman translation of qualifications
scope_german_translationstringOptionalGerman translation of scope
Update EOR Contract — request body — body data scope
FieldTypePresenceDescription and constraints
$JSONRootScope of work description, either as a plain string or as a reference to a scope template.
$ (oneOf 1)stringAlternativeMaximum length: 10000
Minimum length: 100
$ (oneOf 2)ModelAlternativeExpand Update EOR Contract — request body — body data scope Reference to a scope template or validation

Referenced models: Update EOR Contract — request body — body data scope Reference to a scope template or validation

Update EOR Contract — request body — body data work eligibility
FieldTypePresenceDescription and constraints
$objectRootWork eligibility documentation
file_namestringRequired within parentName of the work eligibility document file
keystringRequired within parentUnique identifier for the work eligibility document

SDK function policy ID: deel.eorcontract_updateeorcontract. Catalog operation: eorcontract_updateeorcontract. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["contracts:write"]

Pinned headers: {"X-Version": "2026-01-01"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.