---
title: "Create a new deployment"
method: POST
path: "/cmmn-repository/deployments"
tags: ["Deployment"]
---

# Create a new deployment

`POST /cmmn-repository/deployments`

## Request

- Base URL: `https://developer-docs.flowable.com/cmmn-api`
- URL: `https://developer-docs.flowable.com/cmmn-api/cmmn-repository/deployments`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-cmmn-rest-api/docs/cmmn-repository/deployments/post.ts> (a function with typed inputs; its response is checked against the schema)

The request body should contain data of type multipart/form-data. There should be exactly one file in the request, any additional files will be ignored. The deployment name is the name of the file-field passed in. If multiple resources need to be deployed in a single deployment, compress the resources in a zip and make sure the file-name ends with .bar or .zip.

An additional parameter (form-field) can be passed in the request body with name tenantId. The value of this field will be used as the id of the tenant this deployment is done in.

## Query parameters

- `deploymentKey` string
- `deploymentName` string
- `tenantId` string

## Request body `multipart/form-data`

- object
  - `file` string, binary, required

## Response `201`

Indicates the deployment was created.

- CmmnDeploymentResponse
  - `id` string
  - `name` string
  - `deploymentTime` string, date-time
  - `category` string
  - `parentDeploymentId` string
  - `url` string
  - `tenantId` string

## Other responses

- `400`: Indicates there was no content present in the request body or the content mime-type is not supported for deployment. The status-description contains additional information.

---

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