get_timeline
Retrieve detailed execution records for specific workflow steps to inspect outputs, status, and metadata.
Instructions
Get a single timeline (step execution record) by ID. Returns the full timeline including eventContent (step output), status, metadata, and context. Use this to inspect a specific step's result in detail.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflowId | Yes | The workflow ID | |
| executionId | Yes | The execution ID | |
| timelineId | Yes | The timeline ID |
Implementation Reference
- src/tools/executions.ts:97-115 (handler)The MCP tool registration and handler implementation for 'get_timeline'.
server.tool( 'get_timeline', `Get a single timeline (step execution record) by ID. Returns the full timeline including eventContent (step output), status, metadata, and context. Use this to inspect a specific step's result in detail.`, { workflowId: z.string().describe('The workflow ID'), executionId: z.string().describe('The execution ID'), timelineId: z.string().describe('The timeline ID'), }, async ({ workflowId, executionId, timelineId }, extra) => { const client = clientFactory(extra); const result = await client.getTimeline(workflowId, executionId, timelineId); return { content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2), }], }; } ); - src/client.ts:220-222 (helper)The API client method that performs the actual network request to fetch the timeline.
async getTimeline(workflowId: string, executionId: string, timelineId: string) { return this.request(`/workflows/${workflowId}/executions/${executionId}/timelines/${timelineId}`); }