> ## 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 Team Runs > List runs for a team within a session, optionally filtered by status. Useful for monitoring background runs and viewing run history. ## OpenAPI ````yaml get /teams/{team_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: /teams/{team_id}/runs: get: tags: - Teams summary: List Team Runs description: |- List runs for a team within a session, optionally filtered by status. Useful for monitoring background runs and viewing run history. operationId: list_team_runs parameters: - name: team_id in: path required: true schema: type: string title: Team 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) responses: '200': description: List of runs retrieved successfully content: application/json: schema: type: array items: $ref: '#/components/schemas/TeamRunSchema' '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 team '404': description: Team 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: TeamRunSchema: properties: run_id: type: string title: Run Id description: Unique identifier for the team run parent_run_id: anyOf: - type: string - type: 'null' title: Parent Run Id description: Parent run ID if this is a nested run team_id: anyOf: - type: string - type: 'null' title: Team Id description: Team ID that executed this run status: anyOf: - type: string - type: 'null' title: Status description: Run status (PENDING, RUNNING, COMPLETED, ERROR, etc.) content: anyOf: - type: string - additionalProperties: true type: object - type: 'null' title: Content description: Output content from the team run 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 run_input: anyOf: - type: string - type: 'null' title: Run Input description: Input provided to the run run_response_format: anyOf: - type: string - type: 'null' title: Run Response Format description: Format of the response (text/json) metrics: anyOf: - additionalProperties: true type: object - type: 'null' title: Metrics description: Performance and usage metrics tools: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tools description: Tools used in the run messages: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Messages description: Message history for the run events: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Events description: Events generated during the run created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: Run creation timestamp references: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: References description: References cited in the run 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 session_state: anyOf: - additionalProperties: true type: object - type: 'null' title: Session State description: Session state at the end of the run input_media: anyOf: - additionalProperties: true type: object - type: 'null' title: Input Media description: Input media attachments images: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Images description: Images included in the run videos: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Videos description: Videos included in the run audio: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Audio description: Audio files included in the run files: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Files description: Files included in the run response_audio: anyOf: - additionalProperties: true type: object - type: 'null' title: Response Audio description: Audio response if generated followups: anyOf: - items: type: string type: array - type: 'null' title: Followups description: Followup suggestions generated after the run forked_from_run_id: anyOf: - type: string - type: 'null' title: Forked From Run Id description: If this team run was forked from another run, the source run's ID forked_from_message_index: anyOf: - type: integer - type: 'null' title: Forked From Message Index description: >- If this team run was forked, the message index at which the source was truncated forked_from_session_id: anyOf: - type: string - type: 'null' title: Forked From Session Id description: >- If this team run was created via session branch, the source session's ID regenerated_from: anyOf: - type: string - type: 'null' title: Regenerated From description: >- If this team run was produced via regenerate=true, the source run's ID last_checkpoint_at_message_index: anyOf: - type: integer - type: 'null' title: Last Checkpoint At Message Index description: >- Message index of the most recent mid-run checkpoint (checkpoint='tool-batch' runs) type: object required: - run_id title: TeamRunSchema 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.