---
id: approval-action-link-checklist-specification
title: "Link checklist specification to action"
description: "Points an approval action at a checklist specification version."
sidebar_label: "Link checklist specification to action"
hide_title: true
hide_table_of_contents: true
api: eJztV1tv2zYU/ivEeVoD1XZuwyagD2nXYRkGLEhTtEBiuMfUscWGIlWSsusa+u/DoSRHyqVJH7oCw/KgyNThuXznvoWMvHSqDMoaSOHMKhO8QCOwLJ1doRYo+ZvAIFDInOS1Vj4IX5JUCyUxflyR88qa0ZW5MmmaKrOwV+bEdHddZbxgHj0Ge3vW7e3xaWm1kop8IgytyIm5DflInC5EyKnj4IPSWuTod9QCQ0CZU5aIkCsvJGotFqi0F2sVcvHhaPLrB4EmEygK8h6XJAwWyixFbteiQLPp8XIklIkC17gZiXNCmQtbBRFsPDWV1qXGsLCuEIGw4A+FXVGEqtEx5IyRdoTZZmfyToQ1wfYBGEWkrgwkYEtyEcfTDFLogJ81bFOtzPVsd202AB4SCLj0kF7CSaSGaQKeZOVU2EB6uYU5oSN3UoUc0stpPU2gRIcFBXI+Eih2e4khhwQMFsQaRFYzlUECXuZUIKRbCJuSPyoTaEkO6gQcfaqUowzS4CpKboXSRU7i9DdhWz8Ow2kECdBnLEpNkO7/cnTAmjE/8uGlzTYsUFoTyAR+xbLUrcnjj57Zb3ua3ehxCQ8Axcaw7Y6xDop8FPAw7Y29PjhllnCfdffmQD9q1xy0rjLilsHAN2c4l/sHhxktjo5/XubqI9Txj3HwpTW+UfJgMuF/d6Xvokas0QtfSUneLyrNkp4M3RCQgeGdo29b/g0+TcA48ziW73Jy1Mct6kx+iJl1SzTqS7TkxX6KUtrKhBcHKUetL1HSi0OOSjIhBv9TPNjQ9kUv7YqcuSU6o1LbTcGI1kmbHk8TcOOkp8tIpSMMxKK+e4Qau+5K1bdE6NH793eD8pVWZIIg56wTuxgWWUVcLJVZoVaZUKasgrBOFMp7rsY39eibIrc13s4/kgyQDIqADxgq/8pmxDaxPpBA2wTuloEe9ePR/8fFxZlobghpMxKOSkeeA8ksI7Id5kL28fiJRstRIo4mE37s8+OQH0fPBrgfTSbs9qEuDzj4RBQoc2XoObccnGtqZUW9YjeSGGhpnfpCvtGNHHdYbpOVo6HH55jN2goc0yjC9gQl5k7RIhF5VaC50aRH1ZWLRjlm16FxBS8xE+eN0Cvgg7cGq5BHlbMrGILTp2YVO48+rmSWKX5FLTIKcUbAeezunVpDOZw6LRSxuBaoufFTJiK6JqAylO1Cuh/BXYYc35chbxr4b2eIMlmMc7PkaUJ5X5Fo0/Tk7FR4ldF/LDV8H4g2GI45NY4nB/w4HDr++MdlBRvrDOpZQzRrIPvX8uO0FS/a0HnNNE2m8ImSJN4aXKHSzPVOwtx7/bumzokRlaHPJclAWWuSlbJyjrKRONOEnkRwG4FLVEZoDOS6rIl6hdzyFFxaz6EbB9MUxt2oMW761ni7m1Hr8cOzceOzZs6tnIYU8hBKn47HWKpRf6YfSVtA3Rue33A2NUnQH6F3cDGjbjyO1TMSQdK+/G5dgQFS+PPdBbBhnKXnN/Pt6w6wr0+hD7XhBHjF4tttT4cU9keT0YQXAhUaT7SQMTWjWWAsE+2M/5cy1w+uc7ypyBbDQTj0hvL/V8UfsSq20RfocxiXGpVh78bQ3ra5crlbIGE3qiaQ9ne6hxJmmkDOaZdewnY7R09vna5rPv5UkeN9cprACp3iWhOTKlOe3zNIF6j97RWwHy0/nbdN6Jl4dDG818j2EM0GWAld8S9I4Jo2g5W1ntYJ5IQZuahi8/1Vo8jzC+Zyc/9OH62T7saJlFSGr9JOe/Xq7O83F5z97e5axF4FDtfcf3Hd6GojMLGoxLMtaDTLKhZiaHhyrcBhqblVWqJV96Kx3TYUF/aaTF3vwAn8m4Gp638AHGlIFw==
sidebar_class_name: "post 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={"Link checklist specification to action"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/approval/action/{action_id}/checklist_specification"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Points an approval action at a checklist specification version.

:::info
An action runs on a checklist **or** on policies, never both. If the action still has policies attached, this call fails with `409` and a message naming how many policies are in the way. Reach out to the nullplatform team to move an action that already runs on policies onto a checklist.
:::


<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"action_id","schema":{"type":"integer"},"required":true,"description":"The ID of the approval action.","example":1842}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"required":["checklist_specification_id"],"properties":{"checklist_specification_id":{"type":"string","description":"The specification version the action will run on.","example":"spec_abc123def456ghij"}}}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"properties":{"id":{"type":"integer","description":"ID of the approval action.","example":1842},"nrn":{"type":"string","description":"Where the action applies.","example":"organization=1:account=2:namespace=3"},"entity":{"type":"string","description":"The entity the action governs.","example":"deployment"},"action":{"type":"string","description":"The operation the action governs.","example":"deployment:create"},"checklist_specification_id":{"type":"string","description":"The specification version the action now runs on.","example":"spec_abc123def456ghij"}}}}}},"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>