---
id: action-item-category-delete
title: "Delete a category"
description: "Delete an action item category."
sidebar_label: "Delete a category"
hide_title: true
hide_table_of_contents: true
api: eJzNVttu20YQ/ZXBvCQxWFpJnD7woYAau6iLXgLbbQOYgjPiDsVNyF1md+lGEfjvxSypq+06eSjaF0pa7dzOnBmeFSr2hdNt0NZghqdcc2AgA1TIEejADRQUeGHdMs1Nbr6Do6NfbeDs6Aimm7+gIGNsgDmDij4U6BJ0gIo8+G4+3tPswbpd5z6FC27sLcu5Y/JeLwyEynqGUjsf0txggrZlR2J0rjDDwf5G7G/WGWRDXEww0MJjdo3TIcq5lPB6vIWzBD0XndNhidn1CudMjt20CxVm17N+lmBLjhoO7Hy8oAWXlkKFCRpqGDPUChP0RcUNYbbCsGzl1AenzQL7BB1/7LRjhVlwHScHGF9VvIXt/DTFBPkTNW0tTmhePH/xUnF58upblGwc+9Yaz14ivZicyMe+v3VpG+B9VxTsfdnV9TKVfE7evr3HrNZsArBzEfgxCqiOIVjQ5pZqrUCbtgsJNNp7bRawxSaRfnWGulBZpz+zAopRI0cu+GPHPkD0Eds2xPHQeQYCpcuSnYT3FbWc5ebdu3fvvTW5WeUGII+Y5phBjn9sfJyJixyT4cbgUO5cryDHhr2nxWgzt2oJTeeFfrcM635A64RHYQlPFJfsbjoTdP0kR+hnueljFpFthTWBTRDQqG1rXcT4x5KhnG1bbw3/VkaajCSw8/dcBDzs+WUgo8ipA7il91uyXKMPFDr/2iqhcbyKyboyYe6Yvx7YsHN7y0JtAi/Y3cngx6urNzBYQGEVw1NOF2kCJ5OJPJ7L46U8Tp7tMfJkMukFkL0gI9UPY/xCRaUNf+OYFM1rHqsV432Wz0nduIEjws+h0kfdX1bWBdg5A1tCqNZhxHg/zPek4GIbZg3ko4GmSmn5SjUoDqRrDzS3XdgG248jEz2WA3+Rh4bq0rqGFcTqTSBtZCGOM7UdohT7vk8eI89D0/QgjaK7EVZ/lzdDtLsgbAs6mLlNj3bMkZyjJSYYl/jO+aaI/aD/AP4OLx6d22FiBba+72fySPDVfevtkt0tuzvrTRsVp9ks5CWnve8YrImNnb45B68Hqn7xAjgs+r+aZsetY88mVibV+JYLXeoC/A4Qe7R99RWTPYXm4dmGUFFYv9L0Z/ZDAkPcknTduYPBlLKcofpmuHTDeyz7knTmTnOZQNU1ZLY5fcVuOB9TgJEoG6L/a1tiaqAz/KnlQl7SQ162KDonDB85OOCRjvyO2YTKiuTZqJsoRTI8vk8DHa+06kWbRDeDfulcjRlWIbQ+Oz6mVqemq+u2piA7Ki1sE3XGWhRdCrUHRu5Kow0Y4mitfuLIxkuYjF9+sK6hgBn+9OcVSgHalFbMJZ8Bt+fpJJ2ITNNhwGUr07w0oLU+NBTnbNRba1W6kU2HvVhtB/b/K2FHAAN/CsdtTdpIsbE7q7Gp1/cKW0ww00oWRmV9kFur1Zw8/+7qvpfjjx07EbOzBG/JaZmE2HmlvXxXmJVU+0MduovZ04txbT2De9TpvYmv3wJG8rulupNfmOAHXg4KuZ/1CVZMil3MZvhjWhTchh2TO+tVyLhh/enZz2dXZ5gg7bPwgHW7Cmw/o9VquHFlP7Dp+02CQX5jfIP8DRZKiaM=
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 a category"}
>
</Heading>

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



Delete an action item category.

> **Note:** A category cannot be deleted if it has subcategories or action items. Remove or reassign those first.


<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 category ID.","example":"abc123def456"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"204":{"description":"Category 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>