0007: Jobs added from a link¶
- Date: 2026-11-10
- Status: accepted
Problem¶
Jobs reached Kairos only through a board search. A role the user found elsewhere could not
be tracked: a LinkedIn post, a referral, or a company's own application form (Lyra's
Airtable form, for example). A raw insert under a real board's name looks harmless, but
it would be archived. The daily availability check would ask that board for a posting id
it never issued, take the 404 as "closed", and set closed_at.
Options¶
- Insert such jobs under the nearest board (
linkedin). This breaks the availability check and the detail fetch, as described above. - Add a
manualplatform with no adapter, which the availability check and the detail fetch skip. - Read the posting page and parse it, once per site. This is unbounded work, and application forms such as Airtable or Typeform are rendered by JavaScript.
Choice¶
Option 2.
Platform.MANUAL. It is not searchable, has no adapter, is left out ofdue_for_availability_check, and fit scoring scores it from its stored description.POST /api/v1/jobs. The user givesurl,title,companyandlocation, and optionallycountry,description, salary,visa_sponsorship,notesandstatus(defaultmatched).platform_job_idis a hash of the URL, so the same link is the same job: adding it again returns the saved job with 200. If the same role is already saved and open from a board, that row is returned instead; the cross-board dedupe ofsave_foundapplies.kairos jobs add <url> -t <title> -c <company> -l <location>, with--description-filefor the posting's text. Applying is then recorded withkairos apps set(decision 0006).