list_achievements
Retrieve resume bullet points (achievements) with optional filters by resume ID and keyword query. Supports pagination and multiple match modes.
Instructions
List achievements (resume bullet points), optionally filtered to a specific resume and/or a keyword query matched against the achievement text (absorbs the old search_achievements tool).
Response shape depends on the arguments given, to keep the common case cheap:
resume_id given, query omitted: bare {id, desc} per item (cheapest — you already know which resume these belong to).
query given, and/or resume_id omitted: each item also includes company_name, position_title, work_experience_id, and resume_id, since that context would otherwise be unrecoverable from the achievement alone. 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 for query — 'and' (default) requires all words to appear in the description; 'or' requires any word to match; 'regex' treats query as a case-insensitive regular expression | and |
| limit | No | Maximum number of results to return (default 50) | |
| query | No | Optional text to search for in achievement descriptions (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 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||