v1

latestOpenAPI 3.1.02026-08-062672112.1 KB
Add or Update

Add or update a job.

Add or update a job. Recommendations will be updated shortly to reflect these changes.

post/jobs

Request body

external_idstring required

The unique entity id.

client_dataobject

Optional client-specific data

titlestring required

The job title.

addressesstring[]

The full street address including the country of the hiring locations. If the full street address is not available, the address should be provided up to the most granular level. At least one hiring location is required.

publisher_namestring

The name of the company publishing this job.

publisher_vatinstring

The publisher VAT identification number, or VATIN (https://en.wikipedia.org/wiki/VAT_identification_number).

publisher_descriptionstring

The description of the publisher.

employer_namestring

The name of the employer.

employer_vatinstring

The employer VAT identification number, or VATIN (https://en.wikipedia.org/wiki/VAT_identification_number).

employer_descriptionstring

A description of the employer.

departmentstring

The department or functional area within the company with the open position.

descriptionstring

The job description.

required_qualificationsstring[]

A description of the qualifications and skills required to perform this job.

offer_and_benefits_strstring

A description of the benefits offered with this job.

application_instructions_strstring

The application instructions that a candidate should follow to apply for this job.

compensation_currencystring

The currency of the compensation, defined in ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217).

hourly_gross_compensationnumber

The gross hourly compensation expressed in the corresponding currency.

degreesstring[]

Requested degrees for this job.

seniority_preferencesExperienceLevel[]

The requested work experience for this job.

relationship_preferencesRelationshipType[]

The desired employment relationship.

location_preferencesLocationType[]

The employment location.

employment_term_preferencesTermType[]

The employment term.

capacity_preferencesCapacityType[]

The employment capacity.

workday_preferencesDaysType[]

The employment schedule.

hours_preferencesHoursType[]

The employment hours.

may_be_recommendedboolean

Whether this job may be recommended (subject to the posting publish and expire times).

may_receive_recommendationsboolean

Whether this job may receive recommendations.

Response

Successful Response

{"stackTrail":"paths:/jobs:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}