---
id: suggestion-reject
title: "Reject a suggestion"
description: "Reject a pending suggestion."
sidebar_label: "Reject a suggestion"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post 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={"Reject a suggestion"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/action_item/{actionItemId}/suggestions/{id}/reject"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Reject a pending suggestion.

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

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

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The rejected suggestion.","content":{"application/json":{"schema":{"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"}}}},"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>