Update Job Vacancy Application Disposition Status

This API allows external systems to submit job vacancy application disposition statuses for users so that users can see this within the Talent Marketplace UI, and have it available in reporting.

Use this API for

• Updating the status of a user’s application to a job vacancy

Typical use cases

• Syncing application progress from an external ATS or workflow system
• Enabling users to track application status within Talent Marketplace

Localization

• N/A

Throttling

• 100 requests/minute

Error descriptions

Error Types	Error Message	Error Code
Tenant	tenant is not an Lx-Galaxy tenant	403
User does not exists	User not found for id xyz	404

Errors in response:

• User does not exists in CSX -> "User not found for id: {userId}"
• UserId and userInternalId are empty → "invalid user_id"
• Job vacancy does not exists → "invalid opportunity_id"
• Unsupported/invalid status provided → "unsupported status"
• Invalid date format provided → "invalid date format for status_update_date_time"
• If multiple dispositions exist for the same user+opportunity combo in the same request, the new one must have a later timestamp than the previous one → "Status update with more recent updated time already exists"

Permission required

• N/A

OAuth 2.0 scope vacancydisposition:upsert

Included features

• Submission of application disposition statuses tied to job vacancies

Excluded features

• Full applicant lifecycle management
• External candidate processing