---
title: "Close an action item"
method: POST
path: "/action_item/{id}/close"
tags: ["Action Item"]
---

# Close an action item

`POST /action_item/{id}/close`

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

## Path parameters

- `id` string, required

## Request body

- object
  - `reason` string — Optional reason for closing the item without resolution.
  - `actor` string — The email of the user performing the action. If provided, the caller must be authorized to act on behalf of that user.

## Response `200`

The updated action item.

- ActionItem
  - `id` string — The unique action item ID.
  - `slug` string — Auto-generated URL-friendly slug.
  - `nrn` string — The NRN that owns this action item.
  - `title` string — The title.
  - `description` string — The description. Supports Markdown.
  - `status` 'open' | 'in_progress' | 'pending_deferral' | 'deferred' | 'pending_verification' | 'resolved' | 'pending_rejection' | 'rejected' | 'closed' — The current status.
  - `priority` 'low' | 'medium' | 'high' | 'critical' — Priority level.
  - `score` integer — Calculated score based on value and priority.
  - `category_id` string — The category ID.
  - `value` number — Estimated benefit of resolving the item.
  - `created_by` string — The creator email or agent identifier.
  - `assignee_id` integer — The nullplatform user ID of the item's owner, or `null` when nobody owns it.
  - `assigned_at` string, date-time — When the current assignment was made. ISO 8601 date-time.
  - `assigned_by` string — Who made the current assignment: a user email or an agent identifier.
  - `due_date` string, date-time — Optional deadline. ISO 8601 date-time.
  - `deferred_until` string, date — Date until which the item is deferred.
  - `resolved_at` string, date — Date when the item was resolved.
  - `labels` object — Key-value pairs for classification.
  - `affected_resources` AffectedResource[]
    - `type` string — The resource type.
    - `name` string — The resource name.
    - `permalink` string — A link to the resource.
    - `description` string — A brief description.
  - `references` Reference[]
    - `name` string — The reference name.
    - `permalink` string — A link to the reference.
    - `description` string — A brief description.
  - `metadata` object — Flexible metadata.
  - `deferral_count` integer — Number of times this item has been deferred.
  - `config` CategoryConfig — Deferral limits for a category. Approval gating for resolve, defer, and reject is no longer configured here. It is driven by approval actions in the approvals engine. See the `action_item` entity in the Approval API.
    - `max_deferral_days` integer — Maximum number of days an item can be deferred into the future.
    - `max_deferral_count` integer — Maximum number of times an item can be deferred.
  - `comments` Comment[] — Comments on this item. Populated on read.
    - `id` string — The comment ID.
    - `author` string — The comment author.
    - `content` string — The comment text.
    - `created_at` string, date-time — Creation timestamp.
  - `audit_logs` AuditLog[] — Audit trail of all status transitions and field updates on this item.
    - `id` string — The unique audit log entry ID.
    - `actor` string — The email of the user who performed the action.
    - `action` string — The action that was performed.
    - `details` object — Additional context about the action, such as previous and new status or the deferral reason.
    - `timestamp` string, date-time — When the action was performed.
  - `created_at` string, date-time — Creation timestamp.
  - `updated_at` string, date-time — Last update timestamp.

## Other responses

- `4XX` — Client error responses due to invalid input, missing parameters, or unauthorized access. Request validation errors use a different shape: ```json { "type": "ValidationError", "errors": [{ "message": "body must have required property 'defer_until'" }] } ```
- `5XX` — Server error responses indicating an issue on the API side.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)