Upsert (create/ update) Job Vacancy
Use this endpoint for
- Creating a new job vacancy in talent marketplace
- Partially updating an existing job vacancy
- Fully updating an existing job vacancy in talent marketplace
- If the vacancy exists, all fields are updated.
- If the vacancy does not exist, a new vacancy is created.
Note
When using this API to create a vacancy that does not yet exist, the externalId must be provided both:
- in the path variable, and
- in the request body.
Typical use cases
- Keeping job vacancy data in sync with an external source of truth
Localization
- Updates can be made to one or more language variants of the job vacancy.
Throttling
- 100 requests/minute
Error descriptions
| Error Types | Error Message | Error Code |
|---|---|---|
| Tenant | tenant is not an Lx-Galaxy tenant | 403 |
| Vacancy data | Opportunity not found | 404 |
| Vacancy Request Body | ||
| External Id is missing | Id is required | 400 |
| External Id has invalid characters | Invalid external id | 400 |
| External Id length exceeds | Length of externalId exceeds limit | 400 |
| Job Description is missing | At least one job description is required | 400 |
| Job Description does not set default | Exactly one job description should be set as default to true | 400 |
| Multiple jobDescription with same language | Multiple job descriptions for the same language not allowed | 400 |
| Description is missing | Job description: description is required | 400 |
| Job Details URL is invalid | Invalid job details URL | 400 |
| Apply URL is invalid | Invalid apply URL | 400 |
| Language aCode is invalid and missing | Job description: languageCode is invalid and Job description: languageCode is required | 400 |
| Job Details URL/apply URL | Either JobDetailsURL or applyURL is required | 400 |
| Status is missing | Status is required. | 400 |
| Status is invalid | Invalid job status | 400 |
| Company name length exceeds | Length of company exceeds limit | 400 |
| Start Date Time format | Invalid start date time format | 400 |
| End Date Time format | Invalid end date time format | 400 |
| Location | Only one of the location can be set to true | 400 |
| Location Id length exceeds | Length of location id exceeds limit | 400 |
| Location name length exceeds | Length of location name exceeds limit | 400 |
| City length exceeds | Length of location city exceeds limit | 400 |
| CountryCode | Invalid country code | 400 |
| Region length exceeds | Length of location region exceeds limit | 400 |
| Post Code length exceeds | Length of location postCode exceeds limit | 400 |
| Workplace Model is invalid | Invalid workplacemodel | 400 |
| Job Type is invalid | Invalid jobType | 400 |
| Schedule is invalid | Invalid schedule | 400 |
Permission required
- User or integration must have permission to update job vacancies.
OAuth 2.0 Scope: jobvacancy:update
Included features
- Update of job vacancy metadata and descriptions
Excluded features
- Partial application workflow updates