> ## Documentation Index > Fetch the complete documentation index at: https://docs.maia.ai/llms.txt > Use this file to discover all available pages before exploring further. # List AI Agent Tasks > Returns a list of AI agent tasks for the account, optionally filtered by project, branch, status, or creation time. ## OpenAPI ````yaml /openapi/public-api-endpoint-reference.yaml get /v1/ai/agents/tasks openapi: 3.1.0 info: title: Maia Public REST API version: '1.0' servers: - description: EU1 url: https://eu1.api.matillion.com/dpc - description: US1 url: https://us1.api.matillion.com/dpc security: - bearerAuth: [] tags: - description: Manage Schedules name: Schedules - description: Manage Connections name: Connections - description: Operations for managing Project Variables name: Project Variables - description: Manage Pipelines name: Pipelines - description: Review pipelines against quality rules name: Pipeline Quality Review - description: Execute tests within a project name: Test Execution - description: Manage your AI agent tasks name: AI Agent Tasks - description: SCIM endpoints for user/group permission management name: Directory Integration - description: Publish shared pipeline artifacts name: Shared Pipeline Artifacts - description: Manage Repositories name: Repositories - description: Report on Credit Consumption name: Consumption - description: Manage Artifacts name: Artifacts - description: Operations for data lineage and governance name: Data Lineage - description: Manage Streaming Pipelines name: Streaming Pipelines - description: Execute a pipeline name: Pipeline Execution - description: '' name: Environments - description: '' name: Projects - description: Manage Agents name: Agents - description: Operations for managing Environment-level Overrides of Project Variables name: Project Variable Environment Overrides - description: Query audit events name: Audit Events - description: Connector Profiles name: Connectors paths: /v1/ai/agents/tasks: get: tags: - AI Agent Tasks summary: List AI Agent Tasks description: >- Returns a list of AI agent tasks for the account, optionally filtered by project, branch, status, or creation time. operationId: getTasks parameters: - description: Filter results to tasks belonging to this project. in: query name: projectId required: false schema: type: string - description: Filter results to tasks belonging to this branch. in: query name: branchId required: false schema: type: string - description: Filter results to tasks with the given status. in: query name: status required: false schema: type: string enum: - RUNNING - STOPPED - STOPPING - ERRORED - description: >- Return only tasks created at or after this ISO-8601 timestamp (inclusive). example: '2024-01-15T10:30:00.000Z' in: query name: createdAfter required: false schema: type: string format: date-time - description: >- Return only tasks created at or before this ISO-8601 timestamp (inclusive). example: '2024-01-15T10:30:00.000Z' in: query name: createdBefore required: false schema: type: string format: date-time - in: query name: page required: false schema: type: integer format: int32 default: 0 minimum: 0 - in: query name: size required: false schema: type: integer format: int32 default: 20 maximum: 100 minimum: 1 responses: '200': content: application/json: examples: List of agent tasks: description: Example response listing agent tasks for an account value: tasks: - taskId: 550e8400-e29b-41d4-a716-446655440000 status: RUNNING agentName: data_engineer_agent mode: ACT description: Build a pipeline to load sales data createdAt: '2024-01-15T10:30:00.000Z' modifiedAt: '2024-01-15T10:35:00.000Z' projectId: 550e8400-e29b-41d4-a716-446655440001 branchId: main page: 0 size: 20 total: 1 schema: $ref: '#/components/schemas/GetTasksResponse' description: Agent tasks listed successfully '400': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Invalid filter parameters '401': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Missing or invalid authentication token '403': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Insufficient permissions to list agent tasks '404': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Resource not found '502': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Upstream service error '504': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Upstream service timeout components: schemas: GetTasksResponse: type: object properties: page: type: integer format: int32 description: The current page number (0-indexed) size: type: integer format: int32 description: The number of tasks per page tasks: type: array description: The list of agent tasks for the account items: $ref: '#/components/schemas/TaskSummary' total: type: integer format: int64 description: The total number of matching tasks ProblemDetail: type: object properties: detail: type: string instance: type: string status: type: integer format: int32 title: type: string type: type: string format: uri violations: type: array items: type: string TaskSummary: type: object properties: agentName: type: string description: The name of the agent handling the task example: data_engineer_agent branchId: type: string description: The branch the task is associated with example: main createdAt: type: string format: date-time description: The date and time the task was created example: '2024-01-15T10:30:00.000Z' description: type: string description: A short description of what the agent was asked to do example: Build a pipeline to load sales data from S3 into Snowflake mode: type: string description: The execution mode the task is running in enum: - PLAN - ACT example: ACT modifiedAt: type: string format: date-time description: The date and time the task was last modified example: '2024-01-15T10:35:00.000Z' projectId: type: string description: The ID of the project the task is associated with example: 550e8400-e29b-41d4-a716-446655440001 status: type: string description: The current status of the task enum: - RUNNING - STOPPED - STOPPING - ERRORED example: RUNNING taskId: type: string format: uuid description: The unique identifier of the task example: 550e8400-e29b-41d4-a716-446655440000 securitySchemes: bearerAuth: bearerFormat: JWT description: a valid bearer token scheme: bearer type: http ````