Update a job's application status
freeapply_update_jobUpdate a claimed job's application status—applied, skipped, needs info, account required, or blocked—and record outcomes with truthfulness checks.
Instructions
Sets a claimed job's status: your side of the application (employer's response: freeapply_record_outcome; adding a job: freeapply_claim_job). Use: after a submit (applied); giving up (skipped, failed); 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. Behavior: replaces the status. Enforced: applied needs a fresh freeapply_clear_to_submit clearance for this job; cover_text must pass the truthfulness check; an applied job 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, refused with the answers to use. A field marked for one status is refused with any other. Returns: {job_id, status} and when relevant: already_waiting; questions (each added, duplicate, grouped or already_answered, with its answer), 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>",
"status": "<status>"
},
"name": "freeapply_update_job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | What happened, for the user: one plain sentence, no technical terms, 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 | applied only: 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 | needs_info only, at least one: the form's unanswered questions, each with a plain prompt and the simplest kind of answer that fits. | |
| cover_path | No | applied only: the letter file sent, if not the saved one. | |
| cover_text | No | applied only: the letter sent, if not the saved one. | |
| account_url | No | needs_account only: the site's sign-up page. Jobs with the same one share a card; one "I made the account" re-queues them all. Default: the application link, so jobs rarely share. | |
| letter_sent | No | applied only; required when a letter is saved for the job (freeapply_check_text save): true if attached or pasted, false if not (letter dropped from the record). | |
| resume_path | No | applied only: the résumé file sent, if not the documents copy (recorded by default). | |
| confirmation | No | applied only: the confirmation text or number the site showed. |