Skip to content

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

  1. Insert such jobs under the nearest board (linkedin). This breaks the availability check and the detail fetch, as described above.
  2. Add a manual platform with no adapter, which the availability check and the detail fetch skip.
  3. 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 of due_for_availability_check, and fit scoring scores it from its stored description.
  • POST /api/v1/jobs. The user gives url, title, company and location, and optionally country, description, salary, visa_sponsorship, notes and status (default matched). platform_job_id is 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 of save_found applies.
  • kairos jobs add <url> -t <title> -c <company> -l <location>, with --description-file for the posting's text. Applying is then recorded with kairos apps set (decision 0006).