---
title: "⚠️ Deploy Server"
method: POST
path: "/v1/deploy"
tags: ["Deployments", "Dedicated Servers"]
deprecated: true
---

# ⚠️ Deploy Server

`POST /v1/deploy`

> **Deprecated.**

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

## Headers

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

## Request body

- object
  - `app_name` string, required — Application to deploy.
  - `version_name` string — Version to deploy. If omitted, last created version will be deployed.
  - `ip_list` string[] — Mutually exclusive with geo_ip_list. List of user IPs, determining server location choice.
  - `geo_ip_list` object[] — Mutually exclusive with ip_list. List of user IPs and coordinates, determining server location choice. Coordinates override IP address.
    - `ip` string, required — User public IP address.
    - `latitude` number, required — User latitude.
    - `longitude` number, required — User longitude.
  - `filters` object[] — Restricts possible locations for the deployment.
    - `field` string, required — Deployment field used for filtering.
    - `values` string[], required — Values to compare against.
    - `filter_type` 'any' | 'all' | 'not', required — Filter operator.
  - `env_vars` InjectedEnvVariable[] — List of environment variables to set in your deployment instance. These variables will be available in your container.
    - `key` string, required — Custom key used to access the injected variable within the deployment. Automatically sanitized.
    - `value` string, required — Custom value to inject in your deployment, up to 4 KB.
    - `is_hidden` boolean — Enable encryption at rest to prevent reading the value with API.
  - `tags` string[] — List of tags to mark your deployments for easy filtering.
  - `webhook_url` string — URL to receive simple HTTP notifications in your game backend when the new deployment becomes Ready.
  - `container_log_storage` object — Endpoint storage to upload deployment logs.
    - `enabled` boolean, required — Enable or disable uploading logs.
    - `endpoint_storage` string, required — Endpoint storage identifier to upload deployment logs.
  - `command` string, nullable — Overrides container command for the deployment, use with caution.
  - `arguments` string, nullable — Overrides container arguments for the deployment, use with caution.

## Response `200`

Success

- object
  - `request_id` string, required — ID of your deployment, also referred to as request ID.
  - `request_dns` string, required — FQDN (URL) to connect to the deployment.
  - `request_app` string, required — Application which has been deployed.
  - `request_version` string, required — App version which has been deployed.
  - `request_user_count` integer, required — Number of users included in the deployment request.
  - `filters` V1DeployFilter[], required — List of filters applied to choose the location of the deployment.
    - `field` string, required — Deployment field used for filtering.
    - `values` string[], required — Values to compare against.
    - `filter_type` 'any' | 'all' | 'not', required — Filter operator
  - `tags` string[] — List of tags to mark your deployments for easy filtering.
  - `container_log_storage` unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404`
- `409` — Conflict
- `422` — Unprocessable
- `500`

---

[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)