---
id: action-item-unassign
title: "Unassign an action item"
description: "Remove the owner from an action item, returning it to the unassigned pool. The `assignee_id`, `assigned_at`, and `assigned_by` fields are cleared."
sidebar_label: "Unassign 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={"Unassign an action item"}
>
</Heading>

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



Remove the owner from an action item, returning it to the unassigned pool. The `assignee_id`, `assigned_at`, and `assigned_by` fields are cleared.

The status rule of `action_item:assign` applies here too. Unassigning an item that nobody owns returns a `400`.


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