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

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

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

Lists recommendations for the specified agent space

## Path parameters

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

## Request body

- object
  - `taskId` string — Generic resource identifier (allows alphanumeric characters, hyphens, and underscores; 1-128 characters)
  - `goalId` string — Generic resource identifier (allows alphanumeric characters, hyphens, and underscores; 1-128 characters)
  - `status` 'PROPOSED' | 'ACCEPTED' | 'REJECTED' | 'CLOSED' | 'COMPLETED' | 'UPDATE_IN_PROGRESS' — Status of a recommendation
  - `priority` 'HIGH' | 'MEDIUM' | 'LOW' — Priority level of a recommendation
  - `limit` integer — Maximum number of recommendations to return in a single response
  - `nextToken` string — Pagination token for list operations (1-2048 characters)

## Response `200`

Success

- ListRecommendationsResponse — Response structure containing a list of recommendations
  - `recommendations` Recommendation[], required — List of recommendations matching the request criteria
    - `agentSpaceArn` string, required — ARN of the agent space this recommendation belongs to
    - `recommendationId` string, required — The unique identifier for this recommendation
    - `taskId` string, required — ID of the task that generated the recommendation
    - `goalId` string — ID of the goal this recommendation is associated with
    - `title` string, required — The title of the recommendation
    - `content` object, required — Content of the recommendation
      - `summary` string, required — A brief summary of the recommendation.
      - `spec` string — Agent-ready specification with detailed implementation steps
    - `status` 'PROPOSED' | 'ACCEPTED' | 'REJECTED' | 'CLOSED' | 'COMPLETED' | 'UPDATE_IN_PROGRESS', required — Current status of the recommendation
    - `priority` 'HIGH' | 'MEDIUM' | 'LOW', required — Priority level of the recommendation
    - `goalVersion` integer — Version of the goal at the time this recommendation was generated
    - `additionalContext` string — Additional context for recommendation
    - `rankPosition` integer — Position in ranked list (1 = highest priority)
    - `rankedAt` string, date-time — Timestamp when the recommendation was last ranked
    - `createdAt` string, date-time, required — Timestamp when this recommendation was created
    - `updatedAt` string, date-time, required — Timestamp when this recommendation was last updated
    - `version` integer, required — Version number for optimistic locking
  - `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)