> ## Documentation Index > Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List Workflow Runs > List runs for a workflow within a session, optionally filtered by status. Useful for monitoring background runs and viewing run history. ## OpenAPI ````yaml /reference-api/openapi.yaml get /workflows/{workflow_id}/runs openapi: 3.1.0 info: title: Agno API Reference description: The all-in-one, private, secure agent platform that runs in your cloud. version: 3.0.4 servers: [] security: [] paths: /workflows/{workflow_id}/runs: get: tags: - Workflows summary: List Workflow Runs description: >- List runs for a workflow within a session, optionally filtered by status. Useful for monitoring background runs and viewing run history. operationId: list_workflow_runs parameters: - name: workflow_id in: path required: true schema: type: string title: Workflow Id - name: session_id in: query required: true schema: type: string description: Session ID to list runs for title: Session Id description: Session ID to list runs for - name: status in: query required: false schema: anyOf: - type: string enum: - PENDING - RUNNING - COMPLETED - PAUSED - CANCELLED - ERROR - REGENERATED - type: 'null' description: >- Filter by run status (PENDING, RUNNING, COMPLETED, PAUSED, CANCELLED, ERROR, REGENERATED) title: Status description: >- Filter by run status (PENDING, RUNNING, COMPLETED, PAUSED, CANCELLED, ERROR, REGENERATED) - name: factory_input in: query required: false schema: anyOf: - type: string - type: 'null' title: Factory Input description: >- JSON object with factory-specific parameters for dynamic workflow reconstruction description: >- JSON object with factory-specific parameters for dynamic workflow reconstruction responses: '200': description: List of runs retrieved successfully content: application/json: schema: type: array items: $ref: '#/components/schemas/WorkflowRunSchema' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthenticatedResponse' '403': description: Access denied to run this workflow '404': description: Workflow not found content: application/json: schema: $ref: '#/components/schemas/NotFoundResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' security: - {} - HTTPBearer: [] components: schemas: WorkflowRunSchema: properties: run_id: type: string title: Run Id description: Unique identifier for the workflow run run_input: anyOf: - type: string - type: 'null' title: Run Input description: Input provided to the workflow events: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Events description: Events generated during the workflow workflow_id: anyOf: - type: string - type: 'null' title: Workflow Id description: Workflow ID that was executed user_id: anyOf: - type: string - type: 'null' title: User Id description: User ID associated with the run content: anyOf: - type: string - additionalProperties: true type: object - type: 'null' title: Content description: Output content from the workflow content_type: anyOf: - type: string - type: 'null' title: Content Type description: Type of content returned status: anyOf: - type: string - type: 'null' title: Status description: Status of the workflow run step_results: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Step Results description: Results from each workflow step step_executor_runs: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Step Executor Runs description: Executor runs for each step step_requirements: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Step Requirements description: HITL step requirements (resolved state for historical display) pause_kind: anyOf: - type: string - type: 'null' title: Pause Kind description: 'Kind of HITL pause: ''step'' or ''executor''' paused_step_name: anyOf: - type: string - type: 'null' title: Paused Step Name description: Name of the step that caused the pause paused_step_index: anyOf: - type: integer - type: 'null' title: Paused Step Index description: Index of the step that caused the pause metrics: anyOf: - additionalProperties: true type: object - type: 'null' title: Metrics description: Performance and usage metrics created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: Run creation timestamp reasoning_content: anyOf: - type: string - type: 'null' title: Reasoning Content description: Reasoning content if reasoning was enabled reasoning_steps: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Reasoning Steps description: List of reasoning steps references: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: References description: References cited in the workflow citations: anyOf: - additionalProperties: true type: object - type: 'null' title: Citations description: Citations from the model (e.g., from Gemini grounding/search) reasoning_messages: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Reasoning Messages description: Reasoning process messages images: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Images description: Images included in the workflow videos: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Videos description: Videos included in the workflow audio: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Audio description: Audio files included in the workflow files: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Files description: Files included in the workflow response_audio: anyOf: - additionalProperties: true type: object - type: 'null' title: Response Audio description: Audio response if generated type: object required: - run_id title: WorkflowRunSchema BadRequestResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: BadRequestResponse example: detail: Bad request UnauthenticatedResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: UnauthenticatedResponse example: detail: Unauthenticated access NotFoundResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: NotFoundResponse example: detail: Not found ValidationErrorResponse: properties: detail: anyOf: - type: string - items: $ref: '#/components/schemas/ValidationErrorDetail' type: array title: Detail description: >- A single message for an explicitly raised 422, or a list of field-level errors for a request-validation failure type: object required: - detail title: ValidationErrorResponse description: >- 422 body. Two runtime shapes share this status code, and the same endpoint can return either, so ``detail`` is typed as their union: - FastAPI's request-validation handler emits a **list** of field-level errors (built-in coercion errors and custom-validator ``ValueError``s alike). - A route that raises ``HTTPException(status_code=422, detail="...")`` for a semantic check (e.g. an invalid cron expression) emits a **string** through the HTTPException handler. example: detail: - loc: - body - endpoint msg: Value error, Endpoint must be a path, not a full URL type: value_error InternalServerErrorResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: InternalServerErrorResponse example: detail: Internal server error ValidationErrorDetail: properties: loc: items: anyOf: - type: string - type: integer type: array title: Loc description: Path to the offending field, e.g. ['body', 'endpoint'] msg: type: string title: Msg description: Human-readable error message type: type: string title: Type description: Error type identifier, e.g. 'value_error' or 'missing' type: object required: - loc - msg - type title: ValidationErrorDetail description: >- One field-level error inside a 422 body, matching FastAPI's default shape. securitySchemes: HTTPBearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.