---
title: "Create a new form deployment"
method: POST
path: "/form-repository/deployments"
tags: ["Form Deployments"]
---

# Create a new form deployment

`POST /form-repository/deployments`

## Request

- Base URL: `http://localhost:8090/form-api`
- URL: `http://localhost:8090/form-api/form-repository/deployments`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-form-rest-api/docs/form-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. Make sure the file-name ends with .form or .xml.

## Query parameters

- `tenantId` string

## Request body `multipart/form-data`

- object
  - `file` string, binary

## Response `200`

successful operation

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

## Other responses

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

---

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