Update a job's application status
freeapply_update_jobUpdate a claimed job's status to record that you applied, skipped it, failed, need form answers or an account, or are blocked.
Instructions
Records your side of an application by setting a tracked job's status. Unlike freeapply_record_outcome (what the employer did) and freeapply_claim_job (adding a job), it changes a job you already claimed. Use it after a submit (applied), when you give up on a job (skipped or failed), and when the user must act: needs_info with the form's questions, needs_account with the sign-up page, blocked by a check you can't pass. Not for employer replies. Behavior: replaces the job's status. Enforced: applied needs a fresh clearance from freeapply_clear_to_submit for this job; cover_text must pass the truthfulness check; a job already applied to only the user can change. needs_info questions go to the Needs you tab and re-queue the job once answered; if the user already answered them all, the call is refused with the answers to use. Parameters: note is one plain sentence the user reads, with no technical terms. Some fields go with one status and are refused with any other: questions (at least one) with needs_info; account_url with needs_account; method, confirmation, resume_path, cover_path and cover_text with applied. The résumé copy and the letter saved by freeapply_check_text are recorded by default; pass the file and letter fields only when you sent something else. Returns: {job_id, status}, and when relevant: already_waiting; questions (each added, duplicate, grouped or already_answered, with its answer) and questions_added; same_account (needs_account: jobs sharing one sign-up card); same_site (blocked: jobs blocked on the same site). Errors: an unknown job_id or a broken rule, saying what is missing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | What happened, for the user, e.g. "The site asked to prove you're a person." | |
| job_id | Yes | The job's id, as returned by freeapply_claim_job or freeapply_list_jobs. | |
| method | No | For applied: how it was submitted. | |
| status | Yes | New status: found (qualified, not yet worked), ready (documents prepared, not yet submitted), applied (application submitted), skipped (filtered out (see status_note)), needs_info (a form asked something the profile does not answer), needs_account (employer site requires creating an account), blocked (CAPTCHA, verification code or site warning), failed (error while applying). | |
| questions | No | For needs_info: the form's unanswered questions, each with a plain prompt and the simplest kind of answer that fits. | |
| cover_path | No | For applied: the cover-letter file sent, if not the saved one. Optional. | |
| cover_text | No | For applied: the cover letter sent, if not the saved one. Optional. | |
| account_url | No | For needs_account: the site's sign-up page. Jobs with the same one share a card, and one "I made the account" re-queues them all; without it the application link is used, so jobs rarely share. | |
| resume_path | No | For applied: the résumé file sent, if not the documents copy. Optional. | |
| confirmation | No | For applied: the confirmation text or number the site showed. |