> ## Documentation Index > Fetch the complete documentation index at: https://docs.deck.co/llms.txt > Use this file to discover all available pages before exploring further. # List tasks > Returns a paginated list of tasks. Supports filtering by agent and status. ## OpenAPI ````yaml /api-reference/v2.json get /tasks openapi: 3.1.1 info: title: Deck API version: 2.0.0 servers: - url: https://api.deck.co/v2 description: Production security: - BearerAuth: [] tags: - name: Agents - name: Components - name: Credentials - name: Event Destinations - name: Events - name: Sessions - name: Sources - name: Storage - name: Task Runs - name: Tasks - name: Test paths: /tasks: get: tags: - Tasks summary: List tasks description: >- Returns a paginated list of tasks. Supports filtering by agent and status. operationId: listTasks parameters: - name: limit in: query description: Maximum number of items to return (1-100, default 20) schema: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int32 - name: cursor in: query schema: type: string description: Cursor from a previous response for pagination. - name: agent_id in: query schema: type: string description: Filter by agent ID (prefixed with `agt_`). - name: status in: query description: 'Filter by task status: learning, test, live' schema: type: string responses: '200': description: OK content: text/plain: schema: $ref: '#/components/schemas/PaginatedResponseOfGetTaskResponse' application/json: schema: $ref: '#/components/schemas/PaginatedResponseOfGetTaskResponse' text/json: schema: $ref: '#/components/schemas/PaginatedResponseOfGetTaskResponse' '400': description: Bad request — validation error or malformed input. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' '401': description: Unauthorized. '403': description: Forbidden. '404': description: Not found — the requested resource does not exist. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- Conflict — the request is valid but cannot be completed in the current state. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: >- Unprocessable content — the request body is understood but contains invalid values. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: PaginatedResponseOfGetTaskResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/GetTaskResponse' description: Array of resource objects for the current page. has_more: type: boolean description: '`true` if there are more results beyond this page.' next_cursor: type: - 'null' - string description: >- Opaque cursor string to pass as the `cursor` query parameter on the next request. `null` when there are no more pages. request_id: type: - 'null' - string description: Unique identifier for the API request. ValidationErrorResponse: required: - errors type: object properties: type: type: - 'null' - string description: RFC 9110 problem type URI. title: type: - 'null' - string description: Short summary of the validation failure. status: type: - 'null' - integer description: HTTP status code. format: int32 errors: type: object additionalProperties: type: array items: type: string description: Validation errors grouped by field name. traceId: type: - 'null' - string description: Request trace identifier. description: Validation error returned for malformed requests (HTTP 400). ErrorResponse: required: - errors - request_id type: object properties: errors: type: array items: $ref: '#/components/schemas/TaskRunError' description: One or more errors that describe what went wrong. request_id: type: string description: Unique identifier for this request, useful for tracing. description: Standard error response. GetTaskResponse: required: - id - object - name - prompt - status - agent_id - input_schema - output_schema - storage - created_at - updated_at - request_id type: object properties: id: type: string description: Unique identifier for the task, prefixed with `task_`. object: type: string description: Always `task`. name: type: string description: Display name for the task. prompt: type: - 'null' - string description: Instructions for the agent describing what this task should do. status: type: string description: 'Task status: `learning`, `test`, or `live`.' agent_id: type: string description: The agent this task belongs to. Prefixed with `agt_`. input_schema: oneOf: - type: 'null' - $ref: '#/components/schemas/JsonElement' description: JSON Schema defining the expected input for task runs. output_schema: oneOf: - type: 'null' - $ref: '#/components/schemas/JsonElement' description: JSON Schema defining the expected output for task runs. storage: oneOf: - type: 'null' - $ref: '#/components/schemas/JsonElement' description: Storage configuration for file capture during task execution. created_at: type: string format: date-time description: ISO 8601 timestamp of when the resource was created. updated_at: type: string format: date-time description: ISO 8601 timestamp of when the resource was last updated. request_id: type: string description: >- Unique identifier for the API request. Include this when contacting support. description: A task object. Tasks are defined actions an agent can perform. TaskRunError: required: - type - code - message type: object properties: type: type: string description: >- Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure. code: type: string description: Machine-readable error code. Use this for programmatic handling. message: type: string description: >- Human-readable explanation. Do not rely on this for logic — it may change. field: type: - 'null' - string description: The input field that caused the error, when applicable. description: Error details for a failed task run. Same structure as API-level errors. JsonElement: description: Arbitrary JSON value. securitySchemes: BearerAuth: type: http description: Secret key (sk_live_...) scheme: bearer bearerFormat: JWT ````