---
id: suggestion-list
title: "List suggestions"
description: "List all suggestions for an action item."
sidebar_label: "List suggestions"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/action-items
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List suggestions"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/action_item/{id}/suggestions"}
  context={"endpoint"}
>
  
</MethodEndpoint>



List all suggestions for an action item.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"string"},"required":true,"description":"The action item ID.","example":"xYz789AbCdEf"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"A paginated list of suggestions.","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique suggestion ID.","example":"sUg123AbCdEf"},"slug":{"type":"string","description":"Auto-generated URL-friendly slug.","example":"update-dockerfile-base-image"},"action_item_id":{"type":"string","description":"The parent action item ID.","example":"xYz789AbCdEf"},"status":{"type":"string","enum":["pending","approved","applied","failed","rejected","expired"],"description":"The current status.","example":"pending"},"created_by":{"type":"string","description":"The agent that created the suggestion.","example":"security-scanner-agent"},"owner":{"type":"string","description":"The agent or system that will execute the fix.","example":"image-updater-agent"},"confidence":{"type":"number","description":"Confidence score between 0 and 1.","example":0.92},"description":{"type":"string","description":"A description of the proposed fix. Supports Markdown.","example":"Update the Dockerfile base image to resolve CVE-2026-1234."},"metadata":{"type":"object","description":"Machine-to-machine metadata for the executor.","example":{"repository":"org/my-api-service","branch":"fix/cve-2026-1234"}},"user_metadata":{"type":"object","description":"Human-editable parameters.","example":{"target_version":"20-alpine3.19"}},"user_metadata_config":{"type":"object","description":"JSON Schema for rendering `user_metadata` in the UI."},"execution_result":{"type":"object","description":"Result of a suggestion execution.","properties":{"success":{"type":"boolean","description":"Whether the execution succeeded.","example":true},"message":{"type":"string","description":"A summary message.","example":"Base image updated successfully."},"details":{"type":"object","description":"Additional details, such as a link to the resulting PR.","example":{"pull_request":"https://github.com/org/my-api-service/pull/42"}}},"title":"ExecutionResult"},"executed_at":{"type":"string","format":"date","description":"Date when the suggestion was executed.","example":null},"expires_at":{"type":"string","format":"date","description":"Expiration date.","example":"2026-05-15"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp.","example":"2026-04-06T12:30:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp.","example":"2026-04-06T12:30:00.000Z"}},"title":"Suggestion"}},"pagination":{"type":"object","description":"Pagination metadata returned with list responses.","properties":{"offset":{"type":"integer","description":"The current pagination offset.","example":0},"limit":{"type":"integer","description":"The number of results returned per page.","example":25},"total":{"type":"integer","description":"The total number of items matching the query.","example":42}},"title":"Pagination"}}}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters, or unauthorized access.\n\nRequest validation errors use a different shape:\n```json\n{\n  \"type\": \"ValidationError\",\n  \"errors\": [{ \"message\": \"body must have required property 'defer_until'\" }]\n}\n```\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard error response.","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"Machine-readable error code.","example":"bad_request"},"error":{"type":"string","description":"Short description of the error type.","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}},{"type":"object","description":"Request validation error response.","required":["type","errors"],"properties":{"type":{"type":"string","example":"ValidationError"},"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","example":"body must have required property 'until'"}}}}}}]}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error.","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type.","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred on the server."}}}}}}}}
>
  
</StatusCodes>