Claim or skip a job
freeapply_claim_jobClaims a job before you work on it: runs the duplicate check, applies your rules, starts tracking, and returns the job_id later calls need. Use it before opening any application form.
Instructions
Claims a job before you work on it: runs the duplicate check, applies the user's rules and starts tracking it, returning the job_id every later call needs. Unlike freeapply_list_jobs it adds a job, and unlike freeapply_update_job it makes the job's first record. Use it before opening any application form, and to record a job you reviewed and won't pursue (status skipped, with status_note) so it isn't reviewed again. Not for changing a job you already claimed. Behavior: adds the job unless, in this order: a posting id already tracked returns that job (existing: true; nothing added); a job site the user didn't choose, or one signed out or paused, is refused (refused says why, sites lists the ready ones); the same company and title as a job already applied to is refused as a repost; posted pay below the user's minimum is saved as skipped (rule: pay_floor). Parameters: title and company are required; company is the employer, not a staffing firm, when you can tell. Pass external_id whenever the site shows the posting's id: it catches reposts. url or source tells which job site it came from; the URL just read by freeapply_fetch_posting keeps its keywords. pay_min and pay_max feed the pay floor; fit_score is 0 to 100, as the apply procedure scores it. Returns: {job_id, existing, status, rule, earlier}. earlier lists up to 20 other jobs at the same company as {id, title, company, status, same_title}; if an applied one is clearly the same role under another title, mark this one skipped with freeapply_update_job. Errors: a missing title or company.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The posting's URL; also tells which job site it came from. | |
| title | Yes | Job title, as posted. | |
| source | No | Where it was found: a job site id (linkedin, indeed, company_sites, ...) or referral. | |
| status | No | found to work on it (default), or skipped to record a job you won't pursue. | |
| company | Yes | Employer name, as posted (not the staffing firm's name, if known). | |
| pay_max | No | Highest posted pay as a number. | |
| pay_min | No | Lowest posted pay as a number: annual, or hourly if posted hourly. | |
| location | No | Location as posted. | |
| pay_text | No | Pay exactly as posted, e.g. "$90k-$110k". | |
| apply_url | No | Where the application form is, if different. | |
| fit_notes | No | Why it fits or doesn't, in one sentence. | |
| fit_score | No | Fit from 0 to 100, scored as the apply procedure describes. | |
| work_mode | No | remote, hybrid or onsite, as posted. | |
| description | No | Short description or key requirements. | |
| external_id | No | The posting's id on its source site; finds the same posting again, reposts included. | |
| status_note | No | Why it was skipped, in one plain sentence; for status skipped. |