---
title: "POST /backlog/agent-space/{agentSpaceId}/tasks/list"
method: POST
path: "/backlog/agent-space/{agentSpaceId}/tasks/list"
---

# POST /backlog/agent-space/{agentSpaceId}/tasks/list

`POST /backlog/agent-space/{agentSpaceId}/tasks/list`

Lists backlog tasks in the specified agent space with optional filtering and sorting

## Path parameters

- `agentSpaceId` string, required — Unique identifier for an agent space (allows alphanumeric characters and hyphens; 1-64 characters)

## Request body

- object
  - `filter` object — Filter criteria for listing backlog tasks, supporting time range, priority, status, and type filters.
    - `createdAfter` string, date-time — Filter for tasks created after this timestamp inclusive
    - `createdBefore` string, date-time — Filter for tasks created before this timestamp exclusive
    - `priority` Priority[] — Filter by priority (single value only)
    - `status` TaskStatus[] — Filter by status (single value only)
    - `taskType` TaskType[] — Filter by task type (single value only)
    - `primaryTaskId` string — Filter by primary task ID to get linked tasks
  - `limit` integer — Maximum number of tasks to return in a single response (1-1000, default: 100)
  - `nextToken` string — Pagination token for list operations (1-2048 characters)
  - `sortField` 'CREATED_AT' | 'PRIORITY' — Fields available for sorting tasks
  - `order` 'ASC' | 'DESC' — Sort order options

## Response `200`

Success

- ListBacklogTasksResponse — Response structure containing a list of backlog tasks
  - `tasks` Task[], required — List of backlog tasks
    - `agentSpaceId` string, required — The unique identifier for the agent space containing this task
    - `taskId` string, required — The unique identifier for this task
    - `executionId` string — The execution ID associated with this task, if any
    - `title` string, required — The title of the task
    - `description` string — Optional detailed description of the task
    - `reference` object — Optional reference information linking this task to external systems
      - `system` string, required — The name of the external system
      - `title` string — Optional title for the reference
      - `referenceId` string, required — The unique identifier in the external system
      - `referenceUrl` string, required — URL to access the reference in the external system
      - `associationId` string, required — Association identifier of the external system
    - `taskType` 'INVESTIGATION' | 'EVALUATION' | 'RELEASE_READINESS_REVIEW' | 'RELEASE_TESTING', required — The type of this task
    - `priority` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW' | 'MINIMAL', required — The priority level of this task
    - `status` 'PENDING_TRIAGE' | 'LINKED' | 'PENDING_START' | 'IN_PROGRESS' | 'PENDING_CUSTOMER_APPROVAL' | 'COMPLETED' | 'FAILED' | 'TIMED_OUT' | 'CANCELED' | 'SKIPPED', required — The current status of this task
    - `createdAt` string, date-time, required — Timestamp when this task was created
    - `updatedAt` string, date-time, required — Timestamp when this task was last updated
    - `version` integer, required — Version number for optimistic locking
    - `supportMetadata` object — Optional support metadata for the task
    - `metadata` object — Optional metadata for the task
    - `primaryTaskId` string — The task ID of the primary investigation this task is linked to
    - `statusReason` string — Explanation for why the task status was changed (e.g., linked reason)
    - `hasLinkedTasks` boolean — Indicates if this task has other tasks linked to it
  - `nextToken` string — Token for retrieving the next page of results, if more results are available

## Other responses

- `480` — ValidationException
- `481` — ContentSizeExceededException
- `482` — ServiceQuotaExceededException
- `483` — ConflictException
- `484` — InternalServerException
- `485` — AccessDeniedException
- `486` — ThrottlingException
- `487` — InvalidParameterException
- `488` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/devops-agent.md) · [All operations](https://skmtc.net/aws/apis/devops-agent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/devops-agent/versions/ca2af02d3853/schema)