---
title: "[v2] Deploy"
method: POST
path: "/deployments"
tags: ["Deployments", "Dedicated Servers"]
---

# [v2] Deploy

`POST /deployments`

[Rate Limit: 40 req/s] Create a new deployment - containerized instance of an application version.

## Headers

- `Accept` string
- `Content-Type` string

## Request body

- DeploymentV2
  - `application` string, required — Name of the application that will be deployed
  - `version` string, required — Name of the version within the application that will be deployed
  - `resources` object — Overrides app version resource specification if supplied.
    - `cpu_units` integer, required — Amount of vCPU units assigned to deployment. (1024 units = 1 vCPU).
    - `memory_mib` integer, required — Amount of memory MB assigned to deployment, at most double your vCPU units. (1024 MB = 1 GB).
  - `require_cached_locations` boolean, nullable — Deploy faster by limiting placement to locations with cached image.
  - `users` object[], required — List of users. These users will be used to select the locations for the deployment
    - `user_type` string, required — Type of user (e.g., ip_address or geo_coordinates)
    - `user_data` object, required — Dynamic user data depending on user_type
  - `environment_variables` object[] — List of environment variables to inject into the deployment
    - `key` string, required — Environment variable key
    - `value` string, required — Environment variable value
    - `is_hidden` boolean, required — An hidden environment variable is not shown in the UI
  - `tags` string[] — List of tags to associate with the deployment
  - `webhook_on_ready` BasicWebhook
    - `url` string, required — Webhook URL
  - `webhook_on_error` BasicWebhook
    - `url` string, required — Webhook URL
  - `webhook_on_terminated` BasicWebhook
    - `url` string, required — Webhook URL

## Response `202`

Deployment Request Accepted

- object
  - `request_id` string, required — ID of your deployment, also referred to as request ID.

## Other responses

- `400` — Client Side Request Error
- `401` — Unauthorized - Missing Token
- `422` — Couldn't Allocate Server
- `500` — Internal Server Error

---

[API](https://skmtc.dev/edgegap/apis/edgegap-v2-api.md) · [All operations](https://skmtc.dev/edgegap/apis/edgegap-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edgegap/edgegap-v2-api/revisions/8c42320af012/schema)