---
id: action-item-delete
title: "Delete an action item"
description: "Delete an action item and all its suggestions."
sidebar_label: "Delete an action item"
hide_title: true
hide_table_of_contents: true
api: eJzFVttu3EYM/RWCL0kAdb1pHbTV2zZxURctGthum8JaOFwNtZpEmlHm4nqz0L8XHGmvdurkoeiLLqMhecg5pM4aFfvS6S5oazDHV9xwYCADVMoS6MAtkFFATQM6ePBxuWQv3/wEM7QdO5K3c4U5DkY3YpSr5AozDLT0mF/jbPB4HrjFeYaey+h0WGF+vcYFk2M3i6HG/HrezzPsyFHLgZ1PG7Sg6yjUmKGhljFHrTBDX9bcEuZrDKtOVn1w2iyxz9Dxh6gdK8yDi5wdZXpV80GO568kHb6jtmvEz91fH7/97vvZ4qU6q1AAOfadNZ69BPt6eiq3Q5ezPXdD9gp8LEv2vopNs5oIqtM3b+5bvmw0mwDsnHWwDQQqMgQL2txSoxVo08WQQau912YJuwplYB1EQzHU1umPrIBS1ElhCnPBHyL7AMlHOqohjofoGQiUrip2Et7X1HFemLdv377z1hRmXRiAIlW2wBwK/GPr40xcFJgNOwaHsud6DQW27D0tR5uFVStoow9Q0y3D5lSgc8KdsIIniit2N9EE3TwpEPp5YfqEojCYYWlNYBOkaNR1jS5T/BNBKGs7AljDv1WJLCMV7OIdlwGPT/4ykFHk1FG55fh3lLlGHyhE/9Iq4XDaitkmM+HviF8PhNjbveOiNoGX7O4h+Onq6jUMFlBaxfCUJ8tJBqfTqVyey+UbuZw+OyDl6XTaS0EOgoyEP47xK5W1NvyVY1K0aHjMVowPib4gdeMGjgg/h0wfdX9ZWxdgbw1sBaHehBHjwzA/kIKLXZhNIR8NNFNKyyM1oDiQbjzQwsawC3YYR/p6TAf+Jg8tNZV1LStI2ZtA2rDa9tSuiSbY9332GHk+1U2fpFFyN5bV3+fNEO1+EXYJHfXc9oz2zJGcoxVmKKNnf32bxGHQfyn+Hi8e7duhY6Vsfd/P5ZLhi4fG2yW7W3b3xps2KnWzWcoPR3sfGaxJBzt7fQ5eD1T97AFwnPT/1c2OO8eeTcpMsvEdl7rSJfi9QhzQ9sUXdPYM2k/3NoSaApQUeJl+BX4AMMStSDfRHTWmpOUMNTfDphs+YNnnwFk4zVUGdWzJ7DB9wWw4HyHASJQt0f+zKTEzEA3fdVzKT3rAZcsyOmH4yMGhHpOR3wlNqK3InK20SYIkx5M93XOy1qoXYZKsB/ESXYM51iF0Pj85oU5PTGyarqEgo2lS2jYpjI0iuhRGD0Tc10XbGoijjfRJnZo2YTY+/GhdSwFz/PnPKxTc2lRWzAXPUK7nk+lkKtJMh6EcO2nmpe6d9aGl1F6j2HpQGB4fw3rXq1+uJMfkAt+Fk64hbQRIqtx6rPP1vr7EDHOtpHVr64N8XK8X5Pl31/S9LH+I7ERczjO8JaeFk+kwlPbyrDCvqPHHunA/hacX4wB5Bg+rxQchb0aykYF8S02UN8zwPa8G0drP+wxrJsUuARo+zMqSu7Bncm/WCUW2FHx19svZ1RlmSIfcOOLCvhw6RLReDzuu7Hs2fb8FGOQd0zj/B7sFNgo=
sidebar_class_name: "delete 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={"Delete an action item"}
>
</Heading>

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



Delete an action item and all its suggestions.

<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={{"204":{"description":"Action item deleted successfully."},"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>