---
title: "Create a deployment policy"
method: POST
path: "/v2/deploymentPolicies"
tags: ["Deployment policies"]
---

# Create a deployment policy

`POST /v2/deploymentPolicies`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/deploymentPolicies`
- Auth: HTTP bearer

Create a deployment policy to define what documents to deploy to a tenant organization and how to swap sources for those documents.

### Usage notes
- Retrieve the **versionTagId** by calling the [/v2/tags](https://help.sigmacomputing.com/reference/list-version-tag) endpoint.
- Retrieve the identifier for `sourceSwapPolicies` by calling the [/v2/sourceSwapPolicies](https://help.sigmacomputing.com/reference/list-source-swap-policies) endpoint and using the `policyId` in the response.

## Request body

- object
  - `name` string, required: Name of the deployment policy.
  - `versionTagId` string
  - `sourceSwapPolicies` string[]: Unique identifiers of the source swap policies used to swap connections when deploying documents.
  - `nameInTenant` string: Name to use for the workspace created by the deployment policy in the receiving tenant.
  - `copyInputTableData` boolean: Whether to copy input table data to receiving tenant organizations when deploying documents. Only applies to input tables that are editable in draft mode. Defaults to false.
  - `useDependenciesWorkspace` boolean: Whether to place implicit dependencies in a different workspace, separate from the deployment workspace. Defaults to false.

## Response `200`

The response body.

- DeploymentPoliciesCreateDeploymentResponse200
  - `deploymentPolicyId` string, required

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)