---
id: action-item-close
title: "Close an action item"
description: "Close an action item without resolution. Only the original creator of the action item can close it."
sidebar_label: "Close an action item"
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={"Close an action item"}
>
</Heading>

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



Close an action item without resolution. Only the original creator of the action item can close it.


<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":false,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Optional reason for closing the item without resolution.","example":"This issue was handled outside the platform."},"actor":{"type":"string","description":"The email of the user performing the action. If provided, the caller must be authorized to act on behalf of that user.","example":"jane@example.com"}}}}}}}
>
  
</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>