---
id: checklist-specification-delete
title: "Delete checklist specification"
description: "Soft-deletes a checklist specification."
sidebar_label: "Delete checklist specification"
hide_title: true
hide_table_of_contents: true
api: eJzdVlFv20YM/isEn1pAtZ3EGTC9ZUmKZdhD0SZYgThIaR1tXXK6U++otKmh/z5Qkh3bSbG+bMPmB1k+k3cfP/I7coWGUxFtLTZ4zPFDWMgbw46FExAUJRf3ziaBVHNhF7YgNRzN/MzneW79Isz8W7IuwRcrJXyaTn7+BF9K9kAeqK5jeCAHVKgXJLHOQR2slwQkYGUEV95Zfw9S8tpqYWOSDELsLcGK2pIPUnJ8hiPP85nHDEPNsVu7MJjjBvftjn3eR4YZCi0T5td4ujbEmwwTF0208oj59QrnTJHjSSMl5tc37U2GNUWqWDimzsAqXzVJiRl6qhhztAYzTEXJFWG+QnmsdTVJtH6JbYaRPzc2ssFcYsPZHveXJcPFGYRFx8b3qMcM+StVteu2rrm4pXlxcHhkeDE9/mlZ2jtUsJFTHXzipEAOJ1P9en7cztbwhRL0DJmRwp1+/Pjc7dRZ9gIcY4iwOQVMwyABrH8gZw1YXzeiOaxsStYv4Yk8jaAIXtiL7k517QYA47ukR6yeUxjmd1wIbjN4jUlImnQajCa0w4MZVpwSLVnTWUctCrE9B1vWT/taL7xk9dsN8tfLy3fQe0ARDEPkOnJiLxqLbDEHxTYfr3i0HGUwnUz0caCPI31MX+/kbTqZtErCDpahTPahnEBFRWk9v4lMhuaOh7M6XFKSQEHCyxDtN049No4PHGFB1jWRdytmTuZWSeQkmuKeth8AMY+WFxmUTUX+CcmW1bpue3C63ZqNGf5CBt73h85QF648NVJ2kM0Md8nZtlaI64z+NUhjrL6SA8PSXUo0D408wdo9RwUwUNGVfkVuEWLFBjp2vZD1bDYlvV3BbffJ8PglhXzo6d9XiPWmq3O/1LvRptQwBN+BO3l3Acka/p9JI20TMRTDsUrjeHKoj6PdxB//e6rQYKMnd9sb3faU/WP6uBiOh6F0ztWmV4qu2ILhytMDWae7PhPMi+5/q3ROPDSev9ZcCJshpFAUTYxsRvDOMSUGiY9AS7IeHAnHtWo6XFIG7dObftz10RzH65FhvGl/450eNV5Z02qT7SLtG3ETHeZYitQpH4+ptiPfOFc7EpXzqAhV1xHX3f2DKqgv/O0ev6FIN1q38e7G7IwwG17ehliRYI6//XGJGowOQequeHo2D0aT0USHDCs9W0NQmpI6JKmok/IwNJx1HHyv3++navV0Qfx3h7WBaeGvMq4dWa/MdGlcDZVwjWs8eiVuhrQM98nJrdELrQxJ1Gu1mlPiq+jaVpc/Nxx1nLvJ8IGiVfV0JWNs0neD+YJc2p/Etjl+9X64Vl/DD89nL4Y3LJJ/RAXjGv2FGd7zYz85tjdthiWT4dhh7P84KQquZcvlWVPQ2t4I6uz89/PLc8yQdot6r4i7A15EtFr1Fpfhnn3bbgCK/laMbfsnHxA9Mg==
sidebar_class_name: "delete api-method"
info_path: docs/api/approval
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 checklist specification"}
>
</Heading>

<MethodEndpoint
  method={"delete"}
  path={"/approval/checklist/specification/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Soft-deletes a checklist specification.

:::info
Fails with `409` when an approval action still points at it. Unlink the action first, or point it at another specification.
:::


<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 ID of the checklist specification.","example":"spec_abc123def456ghij"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"204":{"description":"The specification was deleted."},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"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 (e.g., 500, 502, 503).","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 (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>