Openings

Added value: +"What the candidate is actually looking for, stated explicitly rather than guessed from the resume. Every field is optional; the ones given narrow the result, and the excluded* fields remove roles the candidate does not want to see."

Added value: +"Two-letter codes the candidate may work in, such as IN or US. This is eligibility to work, not where the office is"

Added value: +"Two-letter codes to drop even when a role is otherwise eligible"

Added value: +"Cities or regions to drop, matched like locations"

Added value: +"Role titles to drop, matched like roles"

Added value: +"Words that disqualify a role, matched as whole words in the title, such as \"intern\" or \"sales\""

Added value: +"Cities or regions to keep, matched as case-insensitive substrings of the job's location, such as \"Bengaluru\" or \"Delhi NCR\""

Added value: +"True to keep only remote roles, false to drop them; omit to keep both"

Added value: +"Skills a role must state to be kept, such as \"kubernetes\". Each is matched as a whole word"

Added value: +"Role titles the candidate is looking for, in their own words, such as \"backend engineer\" or \"data analyst\". Matched against the job title"

Added value: +"Levels to keep, in the posting's own vocabulary, such as \"senior\" or \"lead\". Not a years-of-experience filter: use experienceYears in search_jobs for that"

Added value: +"Stable job id from search_jobs or recommend_jobs"

Added value: +"The resume itself, passed inline. It is parsed in memory for this call and never written to disk, logged, or sent anywhere else."

Added value: +"How content is encoded: plain text, markdown, or base64 of a PDF or DOCX file"

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "assessment": {
+      "additionalProperties": true,
+      "description": "The overall read, with its reasoning",
+      "type": "object"
+    },
+    "interviewPreparationGaps": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "job": {
+      "additionalProperties": true,
+      "description": "The job that was analyzed",
+      "properties": {
+        "age": {
+          "description": "Bucketed posting age; undated means the board gave no date, not that the role is fresh",
+          "enum": [
+            "new",
+            "older",
+            "stale",
+            "undated"
+          ],
+          "type": "string"
+        },
+        "company": {
+          "type": "string"
+        },
+        "eligibleCountries": {
+          "description": "Two-letter codes the role is open to",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "experience": {
+          "additionalProperties": true,
+          "description": "Years the posting itself states as { min, max }; null when it states none, absent when the description was not read",
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "id": {
+          "description": "Stable id to pass to get_job, analyze_job_fit or optimize_resume",
+          "type": "string"
+        },
+        "location": {
+          "type": "string"
+        },
+        "postedDaysAgo": {
+          "type": "number"
+        },
+        "remote": {
+          "type": "boolean"
+        },
+        "title": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "description": "When the board says the role was posted or last updated; absent when the board states none",
+          "type": "string"
+        },
+        "url": {
+          "description": "The employer's own posting, which is where an application is made",
+          "type": "string"
+        },
+        "workMode": {
+          "enum": [
+            "remote",
+            "hybrid",
+            "onsite",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "partiallySupported": {
+      "description": "Requirements with partial evidence, and what is missing",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "profile": {
+      "additionalProperties": true,
+      "description": "What was read from the resume; not stored",
+      "type": "object"
+    },
+    "scores": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "screeningRisks": {
+      "description": "What is likely to stop this application early",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "supported": {
+      "description": "Requirements the resume supports, each with the quoted evidence",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "unsupported": {
+      "description": "Requirements the resume does not evidence at all",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "job",
+    "assessment"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "job": {
+      "additionalProperties": true,
+      "description": "The full job, including its description and the employer's application URL",
+      "properties": {
+        "age": {
+          "description": "Bucketed posting age; undated means the board gave no date, not that the role is fresh",
+          "enum": [
+            "new",
+            "older",
+            "stale",
+            "undated"
+          ],
+          "type": "string"
+        },
+        "company": {
+          "type": "string"
+        },
+        "eligibleCountries": {
+          "description": "Two-letter codes the role is open to",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "experience": {
+          "additionalProperties": true,
+          "description": "Years the posting itself states as { min, max }; null when it states none, absent when the description was not read",
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "id": {
+          "description": "Stable id to pass to get_job, analyze_job_fit or optimize_resume",
+          "type": "string"
+        },
+        "location": {
+          "type": "string"
+        },
+        "postedDaysAgo": {
+          "type": "number"
+        },
+        "remote": {
+          "type": "boolean"
+        },
+        "title": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "description": "When the board says the role was posted or last updated; absent when the board states none",
+          "type": "string"
+        },
+        "url": {
+          "description": "The employer's own posting, which is where an application is made",
+          "type": "string"
+        },
+        "workMode": {
+          "enum": [
+            "remote",
+            "hybrid",
+            "onsite",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "required": [
+    "job"
+  ],
+  "type": "object"
+}

Added value: +"Two-letter codes to report coverage for, such as IN or US"

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "countries": {
+      "description": "Per-country live and recent role counts",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "snapshotUpdatedAt": {
+      "description": "When the index this answer came from was last refreshed",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +"Stable job id from search_jobs or recommend_jobs"

Added value: +"suggestions lists changes to consider; unified_diff shows them as a patch; revised_markdown returns the rewritten resume"

Added value: +"The resume itself, passed inline. It is parsed in memory for this call and never written to disk, logged, or sent anywhere else."

Added value: +"How content is encoded: plain text, markdown, or base64 of a PDF or DOCX file"

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "content": {
+      "description": "The diff or rewritten resume, when that form was asked for",
+      "type": "string"
+    },
+    "gaps": {
+      "description": "What the resume cannot honestly claim, and so was left alone",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "job": {
+      "additionalProperties": true,
+      "description": "The job the revision targets",
+      "properties": {
+        "age": {
+          "description": "Bucketed posting age; undated means the board gave no date, not that the role is fresh",
+          "enum": [
+            "new",
+            "older",
+            "stale",
+            "undated"
+          ],
+          "type": "string"
+        },
+        "company": {
+          "type": "string"
+        },
+        "eligibleCountries": {
+          "description": "Two-letter codes the role is open to",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "experience": {
+          "additionalProperties": true,
+          "description": "Years the posting itself states as { min, max }; null when it states none, absent when the description was not read",
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "id": {
+          "description": "Stable id to pass to get_job, analyze_job_fit or optimize_resume",
+          "type": "string"
+        },
+        "location": {
+          "type": "string"
+        },
+        "postedDaysAgo": {
+          "type": "number"
+        },
+        "remote": {
+          "type": "boolean"
+        },
+        "title": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "description": "When the board says the role was posted or last updated; absent when the board states none",
+          "type": "string"
+        },
+        "url": {
+          "description": "The employer's own posting, which is where an application is made",
+          "type": "string"
+        },
+        "workMode": {
+          "enum": [
+            "remote",
+            "hybrid",
+            "onsite",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "originalOverwritten": {
+      "description": "Always false: the candidate's resume is never modified in place",
+      "type": "boolean"
+    },
+    "output": {
+      "description": "Which form was produced",
+      "enum": [
+        "suggestions",
+        "unified_diff",
+        "revised_markdown"
+      ],
+      "type": "string"
+    },
+    "profile": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "suggestions": {
+      "description": "Each proposed change with the evidence behind it",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "output",
+    "suggestions",
+    "originalOverwritten"
+  ],
+  "type": "object"
+}

Previous value: -"Opaque token returned by the preceding preparation batch"New value: +"Opaque token from the previous call's result. Pass it back to prepare the next batch of at most 25 sources; omit it to start"

Added value: +"Two-letter codes whose sources should be prepared, such as IN or US"

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "continuation": {
+      "description": "Token for the next batch; present only when nextAction is call_again",
+      "type": "string"
+    },
+    "coverage": {
+      "additionalProperties": true,
+      "properties": {
+        "countries": {
+          "description": "Per-country live and recent role counts",
+          "items": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "snapshotUpdatedAt": {
+          "description": "When the index this answer came from was last refreshed",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "crawl": {
+      "additionalProperties": true,
+      "description": "What this batch crawled: selected, succeeded, and the sources that failed",
+      "type": "object"
+    },
+    "networkAttempted": {
+      "description": "Whether this call actually reached out to employer boards",
+      "type": "boolean"
+    },
+    "nextAction": {
+      "description": "call_again means pass continuation back for the next batch; retry_later means the network refused and waiting is the fix",
+      "enum": [
+        "ready",
+        "call_again",
+        "retry_later"
+      ],
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "sources": {
+      "additionalProperties": true,
+      "description": "How many sources are in the catalog, indexed, fresh, stale, missing and pending",
+      "type": "object"
+    },
+    "status": {
+      "description": "ready means searches can run now; partial means sources are still missing",
+      "enum": [
+        "ready",
+        "partial"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "status",
+    "nextAction",
+    "coverage"
+  ],
+  "type": "object"
+}

Added value: +"What the candidate is actually looking for, stated explicitly rather than guessed from the resume. Every field is optional; the ones given narrow the result, and the excluded* fields remove roles the candidate does not want to see."

Added value: +"Two-letter codes the candidate may work in, such as IN or US. This is eligibility to work, not where the office is"

Added value: +"Two-letter codes to drop even when a role is otherwise eligible"

Added value: +"Cities or regions to drop, matched like locations"

Added value: +"Role titles to drop, matched like roles"

Added value: +"Words that disqualify a role, matched as whole words in the title, such as \"intern\" or \"sales\""

Added value: +"Cities or regions to keep, matched as case-insensitive substrings of the job's location, such as \"Bengaluru\" or \"Delhi NCR\""

Added value: +"True to keep only remote roles, false to drop them; omit to keep both"

Added value: +"Skills a role must state to be kept, such as \"kubernetes\". Each is matched as a whole word"

Added value: +"Role titles the candidate is looking for, in their own words, such as \"backend engineer\" or \"data analyst\". Matched against the job title"

Added value: +"Levels to keep, in the posting's own vocabulary, such as \"senior\" or \"lead\". Not a years-of-experience filter: use experienceYears in search_jobs for that"

Added value: +"How many ranked matches to return"

Added value: +"How matches are scored and how weak a match may be before it is dropped"

Added value: +"evidence scores a match only on requirements the resume text supports; keyword scores on term overlap alone"

Added value: +"Whether this call may crawl employer boards before ranking. Crawling costs seconds; the default only does it when the result would otherwise be thin"

Added value: +"With auto, the match count below which a refresh is worth the wait"

Added value: +"auto crawls once only when matches are thin and the snapshot is stale; never keeps the snapshot as it is; always crawls first"

Added value: +"With auto, how old the snapshot must be before a refresh is considered"

Added value: +"The resume itself, passed inline. It is parsed in memory for this call and never written to disk, logged, or sent anywhere else."

Added value: +"How content is encoded: plain text, markdown, or base64 of a PDF or DOCX file"

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "assumptions": {
+      "description": "Anything inferred rather than stated; worth repeating to the candidate",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "coverage": {
+      "additionalProperties": true,
+      "properties": {
+        "countries": {
+          "description": "Per-country live and recent role counts",
+          "items": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "snapshotUpdatedAt": {
+          "description": "When the index this answer came from was last refreshed",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "explanation": {
+      "description": "Why the result looks the way it does, in words meant for the candidate",
+      "type": "string"
+    },
+    "exploration": {
+      "additionalProperties": true,
+      "description": "Direct, hidden title-family and stretch groupings",
+      "type": "object"
+    },
+    "filteredOut": {
+      "additionalProperties": true,
+      "description": "Counts by reason, with a small sample, for roles the intent excluded",
+      "type": "object"
+    },
+    "matches": {
+      "description": "Ranked matches, each carrying the job, its scores, and the resume text that supports them",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "nextActions": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "nextMoves": {
+      "description": "What to try next when the result is thin; relay these instead of inventing advice",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "outcome": {
+      "description": "widened means the date window had to open up to find anything; no_matches means say so rather than searching again silently",
+      "enum": [
+        "matches",
+        "widened",
+        "no_matches"
+      ],
+      "type": "string"
+    },
+    "profile": {
+      "additionalProperties": true,
+      "description": "What was read from the resume. It is returned so claims can be checked, and is not stored",
+      "type": "object"
+    },
+    "ranking": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "refresh": {
+      "additionalProperties": true,
+      "description": "Whether this call crawled, and what it found",
+      "type": "object"
+    },
+    "shortfall": {
+      "additionalProperties": true,
+      "description": "Present when fewer matches came back than asked for",
+      "type": "object"
+    },
+    "snapshot": {
+      "additionalProperties": true,
+      "description": "Age and size of the index these matches came from",
+      "type": "object"
+    },
+    "window": {
+      "additionalProperties": true,
+      "description": "Which age windows were walked and which one the results came from",
+      "type": "object"
+    }
+  },
+  "required": [
+    "outcome",
+    "matches",
+    "explanation"
+  ],
+  "type": "object"
+}

Added value: +"How many jobs to return in this page"

Added value: +"Where the page starts. Use pagination.nextOffset from the previous result rather than counting by hand"

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "guidance": {
+      "description": "How to present these results honestly; meant for the assistant, not the candidate",
+      "type": "string"
+    },
+    "jobs": {
+      "description": "Matches, newest first",
+      "items": {
+        "additionalProperties": true,
+        "description": "One matching job",
+        "properties": {
+          "age": {
+            "description": "Bucketed posting age; undated means the board gave no date, not that the role is fresh",
+            "enum": [
+              "new",
+              "older",
+              "stale",
+              "undated"
+            ],
+            "type": "string"
+          },
+          "company": {
+            "type": "string"
+          },
+          "eligibleCountries": {
+            "description": "Two-letter codes the role is open to",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "experience": {
+            "additionalProperties": true,
+            "description": "Years the posting itself states as { min, max }; null when it states none, absent when the description was not read",
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "id": {
+            "description": "Stable id to pass to get_job, analyze_job_fit or optimize_resume",
+            "type": "string"
+          },
+          "location": {
+            "type": "string"
+          },
+          "postedDaysAgo": {
+            "type": "number"
+          },
+          "remote": {
+            "type": "boolean"
+          },
+          "title": {
+            "type": "string"
+          },
+          "updatedAt": {
+            "description": "When the board says the role was posted or last updated; absent when the board states none",
+            "type": "string"
+          },
+          "url": {
+            "description": "The employer's own posting, which is where an application is made",
+            "type": "string"
+          },
+          "workMode": {
+            "enum": [
+              "remote",
+              "hybrid",
+              "onsite",
+              "unknown"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "pagination": {
+      "additionalProperties": true,
+      "description": "offset, limit, total and nextOffset. nextOffset is null on the last page",
+      "type": "object"
+    },
+    "window": {
+      "additionalProperties": true,
+      "description": "The age window the results came from, and whether it had to widen. Say which window was used",
+      "type": "object"
+    }
+  },
+  "required": [
+    "jobs",
+    "window",
+    "pagination"
+  ],
+  "type": "object"
+}