---
id: action-item-read
title: "Read an action item"
description: "Get a single action item by ID, including its category."
sidebar_label: "Read an action item"
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={"Read an action item"}
>
</Heading>

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



Get a single action item by ID, including its category.

<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":"The 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>