v1

latestOpenAPI 3.0.22026-07-26191278525.6 KB

Offer

Patch Offer

Patches an offer given its id. Note: All required body params in the schema are not enforced in PATCH request, unlike path params.

patch/api/v2/ats/offers/{offerId}

Path parameters

offerIdstring required

ID of an offer in Eightfold

Headers

Authorizationstring required

The secret key to access the api. It starts with the bearer token

Request body

createdAtinteger nullable

Timestamp of when the offer was created

stockVestingFrequencystring nullable

Stock vesting frequency

versionsstring[] nullable

All versions of the offer

stockOptionsTypestring nullable

Type of stock options

offerStatusstring nullable

status of the offer

profileIdstring nullable

unique identifier for profile

candidateAddressstring nullable

Candidate address

currencystring nullable

Currency for compensation

versionstring nullable

Version of the offer

groupIdstring nullable

group id

relocationBonusnumber float nullable

Relocation bonus amount

jobTitlestring nullable

Job title

workplaceType'remote_global' | 'remote_local' | 'hybrid' | 'onsite' nullable

Workplace type. Possible values: ['remote_global', 'remote_local', 'hybrid', 'onsite']

payGradeIdinteger nullable

Pay grade of the offer

variableBonusnumber float nullable

Variable bonus amount

notestring nullable

Additional notes

customInfoobject nullable

Custom info

jobLocationstring nullable

Job location

bonusPayFrequencystring nullable

Bonus pay frequency

joiningDatestring nullable

Joining date

offerIdinteger nullable

Offer id

templateIdinteger nullable

Template id of the template used to create the offer

countryCodestring nullable

Country code

offerLetterobject nullable

Offer letter details

stockOptionsDescriptionstring nullable

Stock options description

candidateEmailstring nullable

Candidate email address

visaTypestring nullable

Visa type

isPeopleManagerRoleboolean nullable

Whether this is a people manager role

stockOptionsTotalVestingYearsinteger nullable

Total years for stock options vesting

isRehireboolean nullable

Whether this is a rehire

watchersstring[] nullable

Watchers

updatedAtinteger nullable

Timestamp of when the offer was last updated

salaryAmountnumber float nullable

Base salary amount

shiftAllowancenumber float nullable

Shift allowance amount

stockOptionsAmountnumber float nullable

Stock options amount

totalCompensationnumber float nullable

Total compensation amount

createdBystring nullable

User email who created the offer

basePayFrequencystring nullable

Base pay frequency

candidateFullNamestring nullable

Candidate full name

joiningBonusnumber float nullable

Joining bonus amount

stockOptionsPercentageVestingstring nullable

Stock options vesting percentage

positionIdinteger nullable

job id

stockVestingStartDatestring nullable

Stock vesting start date

applicationIdinteger nullable

application id

Response