---
id: action-item-update
title: "Update an action item"
description: "Update an action item. Only the fields included in the request body are updated."
sidebar_label: "Update an action item"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "patch 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={"Update an action item"}
>
</Heading>

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



Update an action item. Only the fields included in the request body are updated.

<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={{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"The title of the action item.","example":"Upgrade base image to fix CVE-2026-1234"},"description":{"type":"string","description":"The description. Supports Markdown.","example":"Updated description with more context."},"priority":{"type":"string","enum":["low","medium","high","critical"],"description":"Priority level.","example":"high"},"value":{"type":"number","description":"The estimated benefit value.","example":750},"due_date":{"type":"string","format":"date-time","description":"Deadline for resolving this item. ISO 8601 date-time.","example":"2026-05-15T00:00:00Z"},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Key-value pairs for classification.","example":{"source":"container-scan"}},"affected_resources":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"The resource type.","example":"application"},"name":{"type":"string","description":"The resource name.","example":"my-api-service"},"permalink":{"type":"string","description":"A link to the resource.","example":"https://app.nullplatform.com/applications/4"},"description":{"type":"string","description":"A brief description.","example":"Main API service"}},"title":"AffectedResource"}},"references":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The reference name.","example":"CVE-2026-1234"},"permalink":{"type":"string","description":"A link to the reference.","example":"https://nvd.nist.gov/vuln/detail/CVE-2026-1234"},"description":{"type":"string","description":"A brief description.","example":"NVD entry for this vulnerability"}},"title":"Reference"}},"metadata":{"type":"object","description":"Flexible metadata object."}}}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The updated action item.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The unique action item ID.","example":"xYz789AbCdEf"},"slug":{"type":"string","description":"Auto-generated URL-friendly slug.","example":"upgrade-base-image-to-fix-cve-2026-1234"},"nrn":{"type":"string","description":"The NRN that owns this action item.","example":"organization=1:account=2:namespace=3:application=4"},"title":{"type":"string","description":"The title.","example":"Upgrade base image to fix CVE-2026-1234"},"description":{"type":"string","description":"The description. Supports Markdown.","example":"The current base image has a critical vulnerability."},"status":{"type":"string","enum":["open","in_progress","pending_deferral","deferred","pending_verification","resolved","pending_rejection","rejected","closed"],"description":"The current status.","example":"open"},"priority":{"type":"string","enum":["low","medium","high","critical"],"description":"Priority level.","example":"critical"},"score":{"type":"integer","description":"Calculated score based on value and priority.","example":2000},"category_id":{"type":"string","description":"The category ID.","example":"abc123def456"},"value":{"type":"number","description":"Estimated benefit of resolving the item.","example":500},"created_by":{"type":"string","description":"The creator email or agent identifier.","example":"security-scanner-agent"},"assignee_id":{"type":"integer","description":"The nullplatform user ID of the item's owner, or `null` when nobody owns it.","example":2345},"assigned_at":{"type":"string","format":"date-time","description":"When the current assignment was made. ISO 8601 date-time.","example":"2026-08-20T14:32:00Z"},"assigned_by":{"type":"string","description":"Who made the current assignment: a user email or an agent identifier.","example":"jane@example.com"},"due_date":{"type":"string","format":"date-time","description":"Optional deadline. ISO 8601 date-time.","example":"2026-05-01T00:00:00Z"},"deferred_until":{"type":"string","format":"date","description":"Date until which the item is deferred.","example":null},"resolved_at":{"type":"string","format":"date","description":"Date when the item was resolved.","example":null},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Key-value pairs for classification.","example":{"source":"container-scan","cve":"CVE-2026-1234"}},"affected_resources":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"The resource type.","example":"application"},"name":{"type":"string","description":"The resource name.","example":"my-api-service"},"permalink":{"type":"string","description":"A link to the resource.","example":"https://app.nullplatform.com/applications/4"},"description":{"type":"string","description":"A brief description.","example":"Main API service"}},"title":"AffectedResource"}},"references":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The reference name.","example":"CVE-2026-1234"},"permalink":{"type":"string","description":"A link to the reference.","example":"https://nvd.nist.gov/vuln/detail/CVE-2026-1234"},"description":{"type":"string","description":"A brief description.","example":"NVD entry for this vulnerability"}},"title":"Reference"}},"metadata":{"type":"object","description":"Flexible metadata.","example":{"cve_id":"CVE-2026-1234"}},"deferral_count":{"type":"integer","description":"Number of times this item has been deferred.","example":0},"config":{"type":"object","description":"Deferral limits for a category. Approval gating for resolve, defer, and reject\nis no longer configured here. It is driven by approval actions in the approvals\nengine. See the `action_item` entity in the Approval API.\n","properties":{"max_deferral_days":{"type":"integer","description":"Maximum number of days an item can be deferred into the future.","example":90},"max_deferral_count":{"type":"integer","description":"Maximum number of times an item can be deferred.","example":3}},"title":"CategoryConfig"},"comments":{"type":"array","description":"Comments on this item. Populated on read.","items":{"type":"object","properties":{"id":{"type":"string","description":"The comment ID.","example":"cmt123AbCdEf"},"author":{"type":"string","description":"The comment author.","example":"jane@example.com"},"content":{"type":"string","description":"The comment text.","example":"This should be prioritized for the next sprint."},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp.","example":"2026-04-06T14:30:00.000Z"}},"title":"Comment"}},"audit_logs":{"type":"array","description":"Audit trail of all status transitions and field updates on this item.","items":{"type":"object","description":"A single audit log entry recording a status transition or field update on an action item.","properties":{"id":{"type":"string","description":"The unique audit log entry ID.","example":"3c35f973-d53b-4e60-a578-2e8fba1dbbb1"},"actor":{"type":"string","description":"The email of the user who performed the action.","example":"jane@example.com"},"action":{"type":"string","description":"The action that was performed.","example":"deferred"},"details":{"type":"object","description":"Additional context about the action, such as previous and new status or the deferral reason.","example":{"from":"open","to":"deferred","reason":"Waiting for the next maintenance window."}},"timestamp":{"type":"string","format":"date-time","description":"When the action was performed.","example":"2026-04-06T12:00:00.000Z"}},"title":"AuditLog"}},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp.","example":"2026-04-06T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp.","example":"2026-04-06T12:00:00.000Z"}},"title":"ActionItem"}}}},"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>