Find Environment Jobs by Name
find_jobs_by_nameFind jobs by name in an environment using fuzzy matching, and retrieve each job's ID and recent run history.
Instructions
Fuzzy-match jobs in an environment by name (case-insensitive substring), and return each match with its most recent runs. Use this when the user references a job by name and you need the job's ID or recent execution history.
Scans the last 50 runs in the environment and groups them by matched job. Runs that fall outside that window are not returned — for older history call list_runs with explicit pagination.
Args:
environmentID (string, required): The environment ID
jobName (string, required): Substring to match (case-insensitive)
runLimitPerJob (integer, optional): Max recent runs per matched job (default 5)
Returns: { matches: [{ job: {id, name, includeSelector, excludeSelector}, recentRuns: [{runID, runCounter, runStatus, runType, runStartTime, runEndTime}] }], summary: { jobsMatched, totalRunsReturned, runScanLimit } }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobName | Yes | Substring to match against job names (case-insensitive) | |
| environmentID | Yes | The environment ID | |
| runLimitPerJob | No | Max recent runs per matched job (default 5, max 50) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||