---
title: "POST Submit a policy version for approval"
description: "Submits a specific policy version for approval."
last_updated: "2026-05-06T07:33:51.494192+00:00"
canonical_url: "https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/api/policies/policiescontroller-submitversionforapproval"
---

<APIEndpoint
  method={"POST"}
  path={"/policies/:id/versions/:versionId/submit-for-approval"}
  summary={"Submit a policy version for approval"}
  description={"Submits a specific policy version for approval."}
  deprecated={false}
  baseUrl={""}
/>

## Parameters

<APIParameters parameters={[{"name":"id","in":"path","required":true,"description":"ID of the policy.","schema":{"type":"string"}},{"name":"versionId","in":"path","required":true,"description":"ID of the policy version to submit for approval.","schema":{"type":"string"}},{"name":"X-Organization-Id","in":"header","required":false,"description":"Organization ID (required for session auth, optional for API key auth)","schema":{"type":"string"}}]} />

## Request Body

Data for submitting the version for approval.

<APIRequestBody
  contentType={"application/json"}
  required={true}
  schema={{"type":"object"}}
/>

## Responses

<APIResponse
  statusCode={"200"}
  description={"Policy version submitted for approval successfully."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"400"}
  description={"Bad request."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"401"}
  description={"Unauthorized."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"404"}
  description={"Policy or version not found."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

## Try It

<APIPlayground
  method={"POST"}
  path={"/policies/:id/versions/:versionId/submit-for-approval"}
  parameters={[{"name":"id","in":"path","required":true,"description":"ID of the policy.","schema":{"type":"string"}},{"name":"versionId","in":"path","required":true,"description":"ID of the policy version to submit for approval.","schema":{"type":"string"}},{"name":"X-Organization-Id","in":"header","required":false,"description":"Organization ID (required for session auth, optional for API key auth)","schema":{"type":"string"}}]}
  requestBody={{"contentType":"application/json","required":true,"description":"Data for submitting the version for approval.","schema":{"type":"object"}}}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/llms.txt) for all pages in this wiki.