---
id: suggestion-applied
title: "Mark suggestion as applied"
description: "Report that a suggestion was successfully applied."
sidebar_label: "Mark suggestion as applied"
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={"Mark suggestion as applied"}
>
</Heading>

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



Report that a suggestion was successfully applied.

<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={{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"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"}}}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The applied 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>