list_education
Retrieve education entries filtered by resume, keyword, or competency. Supports pagination and token matching modes.
Instructions
List education entries (degree, institution, year, and relevant coursework/competencies), optionally filtered to a resume and/or matched by keyword or competency (absorbs the old search_education and search_education_by_competency tools).
If competency is given, entries are matched against competency names only, and each result uses a lighter shape: id, institution, degree, year, matched_competencies, resume_id.
Else if query is given, entries are matched against institution, degree, or competency names, and each result includes the full nested structure plus resume_id.
If both are given, competency takes precedence and query is ignored.
If neither is given, today's plain listing behavior applies. Response includes total_count and items for pagination. Returns {"error": ...} if resume_id is given but not found.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Token match mode — 'and' (default) requires all words to match within the same field; 'or' requires any word to match; 'regex' treats query/competency as a case-insensitive regular expression | and |
| limit | No | Maximum number of results to return (default 25) | |
| query | No | Optional text to match against institution, degree, or competency (case-insensitive) | |
| offset | No | Number of results to skip for pagination (default 0) | |
| resume_id | No | Optional resume ID from list_resume_summaries to filter results | |
| competency | No | Optional skill/competency name fragment to match (case-insensitive, partial match); takes precedence over query |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||