list_job_executions
Access execution history and performance metrics of scheduled notebook jobs using job ID. Track status, start/end times, and execution details for improved job monitoring and analysis.
Instructions
Retrieve execution history and performance metrics for a scheduled notebook job.
Returns:
- executions: Array of execution records containing:
- executionID: Unique identifier for the execution
- executionNumber: Sequential number of the run
- jobID: Parent job identifier
- status: Current state (Scheduled, Running, Completed, Failed)
- startedAt: Execution start time (ISO 8601)
- finishedAt: Execution end time (ISO 8601)
- scheduledStartTime: Planned start time
- snapshotNotebookPath: Backup notebook path if enabled
Args:
job_id: UUID of the scheduled job
start: First execution number to retrieve (default: 1)
end: Last execution number to retrieve (default: 10)
Returns:
Dictionary with execution records
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ctx | No | ||
| end | Yes | ||
| job_id | Yes | ||
| start | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"Context": {
"description": "Context object providing access to MCP capabilities.\n\nThis provides a cleaner interface to MCP's RequestContext functionality.\nIt gets injected into tool and resource functions that request it via type hints.\n\nTo use context in a tool function, add a parameter with the Context type annotation:\n\n```python\n@server.tool()\ndef my_tool(x: int, ctx: Context) -> str:\n # Log messages to the client\n ctx.info(f\"Processing {x}\")\n ctx.debug(\"Debug info\")\n ctx.warning(\"Warning message\")\n ctx.error(\"Error message\")\n\n # Report progress\n ctx.report_progress(50, 100)\n\n # Access resources\n data = ctx.read_resource(\"resource://data\")\n\n # Get request info\n request_id = ctx.request_id\n client_id = ctx.client_id\n\n return str(x)\n```\n\nThe context parameter name can be anything as long as it's annotated with Context.\nThe context is optional - tools that don't need it can omit the parameter.",
"properties": {},
"title": "Context",
"type": "object"
}
},
"properties": {
"ctx": {
"anyOf": [
{
"$ref": "#/$defs/Context"
},
{
"type": "null"
}
],
"default": null
},
"end": {
"title": "end",
"type": "string"
},
"job_id": {
"title": "job_id",
"type": "string"
},
"start": {
"title": "start",
"type": "string"
}
},
"required": [
"job_id",
"start",
"end"
],
"title": "list_job_executionsArguments",
"type": "object"
}