Job Openings - Sublity API

A job is the role. A job opening is one seat to fill.

A customer hiring three nurses has one job and three openings — and those three can differ from one another: different start dates, different contract types, one full time and two at half FTE. If you are filling seats rather than advertising roles, this is the feed you want.

Openings sit under Read Jobs rather than a permission of their own, because they are the structure of a job rather than a separate class of information.

foreign_key_ids are your ids for the opening, when the record reached us from your system before the integration existed — an empty list when we hold none, and every one of them when more than one of your sources holds a key. Match it against your own records instead of creating them again. Several openings can carry the same key: one of your jobs with a quantity of three is three openings here, all carrying your one job id. The link survives the customer merging duplicate jobs, because the openings move under the surviving job and keep your key. You only ever see your own keys, never another system's.