Dedicated Servers

⚡ Deployments

[v2] Deploy

post

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

Authorizations

apiKey1

AuthorizationstringRequired

Manage API tokens in dashboard.

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

application/json

applicationstringRequired

Name of the application that will be deployed

Example: my-game-server

versionstringRequired

Name of the version within the application that will be deployed

Example: 25.05.30-16.45.19-04

require_cached_locationsboolean · nullableOptional

Deploy faster by limiting placement to locations with cached image.

Default: false

tagsstring[]Optional

List of tags to associate with the deployment

Example: my-custom-tag

Responses

202

Deployment Request Accepted

application/json

400

Client Side Request Error

application/json

401

Unauthorized - Missing Token

application/json

422

Couldn't Allocate Server

application/json

500

Internal Server Error

application/json

post

/deployments

HTTPcURLJavaScriptPython

POST /v2/deployments HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "application": "my-game-server",
  "version": "production",
  "users": [
    {
      "user_type": "ip_address",
      "user_data": {
        "ip_address": "75.28.35.192"
      }
    }
  ]
}

{
  "request_id": "a69f8e3e0555"
}

Get Deployment

get

[Rate Limit: 20 req/s] Get the specified deployment status and information.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: 61b1be8f54d9

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

request_idstringRequired

ID of your deployment, also referred to as request ID.

Example: c0653765de3b

fqdnstringRequired

FQDN (URL) to connect to the deployment.

Example: c0653765de3b.pr.edgegap.net

public_ipstringRequired

Public IP address of the host.

Example: 192.53.120.48

app_namestringRequired

Application which has been deployed.

Example: test

app_versionstringRequired

App version which has been deployed.

Example: v1

current_statusstringRequired

Indicates whether deployment is Ready, in Error, or otherwise.

Example: Status.SEEKING

runningbooleanRequired

True if deployment is Ready for connections.

Default: trueExample: true

start_timestring · date-timeRequired

Timestamp of deployment becoming Ready.

Example: 2026-04-22 12:00:46.444265

elapsed_timeintegerRequired

Seconds since deployment becoming Ready.

max_durationinteger · min: -1 · max: 1440Required

Maximum allowed uptime minutes of deployments before automatically stopped.

Example: 1440

removal_timestring · date-timeOptional

Timestamp of deployment stopped.

Example: 2026-04-22 12:00:46.444265

last_statusstringOptional

Previous status of deployment.

Example: Status.SEEKING

errorbooleanRequired

Indicates an error with the deployment.

Default: falseExample: true

error_detailstringOptional

Details of the error.

Example: Pull image timeout exceeded

tagsstring[]Optional

List of tags to mark your deployments for easy filtering.

Example: production

commandstringOptional

Overrides container command for the deployment, use with caution.

Example: echo "hi" && sleep infinity

argumentsstringOptional

Overrides container arguments for the deployment, use with caution.

400

Bad Request

application/json

401

Unauthorized

application/json

404Error

application/json

500

Internal Server Error

application/json

get

/v1/status/{deployment_id}

HTTPcURLJavaScriptPython

GET /v1/status/{deployment_id} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "request_id": "c0653765de3b",
  "fqdn": "c0653765de3b.pr.edgegap.net",
  "public_ip": "192.53.120.48",
  "app_name": "test",
  "app_version": "v1",
  "current_status": "Status.SEEKING",
  "running": true,
  "start_time": "2026-04-22 12:00:46.444265",
  "elapsed_time": 1,
  "max_duration": 1440,
  "removal_time": "2026-04-22 12:00:46.444265",
  "last_status": "Status.SEEKING",
  "error": true,
  "error_detail": "Pull image timeout exceeded",
  "ports": {
    "gameport": {
      "name": "gameport",
      "link": "https://c66980ae5bf1.pr.edgegap.net:30345",
      "internal": 7777,
      "external": 30345,
      "protocol": "UDP",
      "tls_upgrade": false
    }
  },
  "location": {
    "city": "Montreal",
    "country": "Canada",
    "continent": "North America",
    "administrative_division": "Quebec",
    "timezone": "Eastern Time",
    "latitude": 45.508888,
    "longitude": -73.561668
  },
  "tags": [
    "production"
  ],
  "command": "echo \"hi\" && sleep infinity",
  "arguments": "text"
}

List Deployments

get

[Rate Limit: 10 req/s] List all deployments, optionally filtered and sorted.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Query parameters

querystringOptional

Query to filter the deployments. See filtering guide. For client integrations, consider Server Browser instead.

Example: {"filters":[{"field":"status","operator":"eq","value":"ready"}]}

pageinteger · min: 1OptionalExample: 2

limitinteger · min: 1OptionalExample: 20

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

messagestring[]Optional

Additional information related to your query.

Example: [""]

total_countintegerRequiredExample: 100

400

Bad Request

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get

/v1/deployments

HTTPcURLJavaScriptPython

GET /v1/deployments HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "request_id": "2d35052ec4e9",
      "fqdn": "abc123.test.edgegap.com",
      "ready": true,
      "start_time": "2026-04-22 12:00:46.444265",
      "public_ip": "100.10.0.85",
      "ports": {
        "gameport": {
          "name": "gameport",
          "link": "https://c66980ae5bf1.pr.edgegap.net:30345",
          "internal": 7777,
          "external": 30345,
          "protocol": "UDP",
          "tls_upgrade": false
        }
      },
      "tags": [
        "production"
      ]
    }
  ],
  "message": [
    ""
  ],
  "total_count": 100,
  "pagination": {
    "number": 1,
    "next_page_number": 2,
    "previous_page_number": 1,
    "paginator": {
      "num_pages": 10
    },
    "has_next": true,
    "has_previous": false
  }
}

Stop Deployment

delete

Request to stop a deployment from your custom backend, triggering a graceful shutdown (SIGTERM). Returns 200 or 202 if deployment status is not READY and not ERROR, and stops deployment once either of these statuses is reached - see Deployment Lifecycle.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: 61b1be8f54d9

Query parameters

container_log_storagestringOptional

Enable or disable previously configured log storage. Alternatively, provide endpoint storage ID to override or set storage to upload logs.

Example: true

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

messagestringRequired

Additional information regarding deployment termination.

Example: 1a9e4ff02cce - Delete request will be processed soon

202

Accepted

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

410

Instance Already terminated

application/json

500

Internal Server Error

application/json

delete

/v1/stop/{deployment_id}

HTTPcURLJavaScriptPython

DELETE /v1/stop/{deployment_id} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "message": "1a9e4ff02cce - Delete request will be processed soon",
  "deployment_summary": {
    "request_id": "c0653765de3b",
    "fqdn": "c0653765de3b.pr.edgegap.net",
    "public_ip": "192.53.120.48",
    "app_name": "test",
    "app_version": "v1",
    "current_status": "Status.SEEKING",
    "running": true,
    "start_time": "2026-04-22 12:00:46.444265",
    "elapsed_time": 1,
    "max_duration": 1440,
    "removal_time": "2026-04-22 12:00:46.444265",
    "last_status": "Status.SEEKING",
    "error": true,
    "error_detail": "Pull image timeout exceeded",
    "ports": {
      "gameport": {
        "name": "gameport",
        "link": "https://c66980ae5bf1.pr.edgegap.net:30345",
        "internal": 7777,
        "external": 30345,
        "protocol": "UDP",
        "tls_upgrade": false
      }
    },
    "location": {
      "city": "Montreal",
      "country": "Canada",
      "continent": "North America",
      "administrative_division": "Quebec",
      "timezone": "Eastern Time",
      "latitude": 45.508888,
      "longitude": -73.561668
    },
    "tags": [
      "production"
    ],
    "command": "echo \"hi\" && sleep infinity",
    "arguments": "text"
  }
}

Stop Deployments

post

Delete multiple deployments using custom filtering. Caution is advised.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

application/json

Responses

202

Accepted

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

post

/v1/deployments/bulk-stop

HTTPcURLJavaScriptPython

POST /v1/deployments/bulk-stop HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "filters": [
    {
      "field": "request_id",
      "values": [
        "c0653765de3b"
      ],
      "filter_type": "any"
    }
  ]
}

{
  "processable": [
    {
      "request_id": "c0653765de3b"
    }
  ]
}

Self-Stop Deployment

delete

Delete a deployment from the inside of a container, available as injected variable ARBITRIUM_DELETE_URL.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: 61b1be8f54d9

stop_keystringRequiredExample: 660

Query parameters

container_log_storagestringOptional

Enable or disable previously configured log storage. Alternatively, provide endpoint storage ID to override or set storage to upload logs.

Example: true

Header parameters

authorizationstringRequired

Auto Generated token. This token is injected in your deployment and can be found via the environment variable named ARBITRIUM_DELETE_TOKEN

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

anyOptional

202

Accepted

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete

/v1/self/stop/{deployment_id}/{stop_key}

HTTPcURLJavaScriptPython

DELETE /v1/self/stop/{deployment_id}/{stop_key} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
authorization: text
Accept: */*

No content

Get Deployment Logs

get

Retrieve the logs of your container, if Endpoint Storage was configured before stopping the deployment.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequired

ID of your deployment, also referred to as request ID.

Example: 61b1be8f54d9

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

logsstringOptional

Plaintext deployment success logs.

Example: Logs of the container

crash_logsstring · nullableOptional

Plaintext deployment crash logs.

Example: Logs of the container when it crashed

encodingstringOptional

Encoding used for logs.

Example: utf-8

logs_linkstring · nullableOptional

Link to retrieve logs from your configured Endpoint Storage.

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/deployment/{deployment_id}/container-logs

HTTPcURLJavaScriptPython

GET /v1/deployment/{deployment_id}/container-logs HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "logs": "Logs of the container",
  "crash_logs": "Logs of the container when it crashed",
  "crash_data": {
    "exit_code": 0,
    "message": "OOM killed",
    "restart_count": 0
  },
  "encoding": "utf-8",
  "logs_link": "text"
}

Get Deployment Metrics

get

Get metrics for the specified deployment in a given time range.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: 61b1be8f54d9

Query parameters

start_timestring · date-timeOptional

Start of reporting time range, defaults to deployment start time.

Example: 2021-07-10 00:00:00.00

end_timestring · date-timeOptional

End of reporting time range, default to deployment stopped time. Must be greater than start time.

Example: 2021-07-10 00:00:00.00

stepsstringOptional

Size of reporting time step between metric values, aggregated using average (mean).

Example: 30s

rawbooleanOptional

Optionally enable raw output.

Default: falseExample: false

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

422

Unprocessable

application/json

500

Internal Server Error

application/json

get

/v1/metrics/deployment/{deployment_id}

HTTPcURLJavaScriptPython

GET /v1/metrics/deployment/{deployment_id} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "total": {
    "receive_total": {
      "labels": [
        "00:00:00"
      ],
      "datasets": [
        1
      ],
      "timestamps": [
        "2021-07-14 14:17:37.711"
      ]
    },
    "transmit_total": {
      "labels": [
        "00:00:00"
      ],
      "datasets": [
        1
      ],
      "timestamps": [
        "2021-07-14 14:17:37.711"
      ]
    },
    "disk_read_total": {
      "labels": [
        "00:00:00"
      ],
      "datasets": [
        1
      ],
      "timestamps": [
        "2021-07-14 14:17:37.711"
      ]
    },
    "disk_write_total": {
      "labels": [
        "00:00:00"
      ],
      "datasets": [
        1
      ],
      "timestamps": [
        "2021-07-14 14:17:37.711"
      ]
    }
  },
  "cpu": {
    "labels": [
      "00:00:00"
    ],
    "datasets": [
      1
    ],
    "timestamps": [
      "2021-07-14 14:17:37.711"
    ]
  },
  "cpu_throttle_rate": {
    "labels": [
      "00:00:00"
    ],
    "datasets": [
      1
    ],
    "timestamps": [
      "2021-07-14 14:17:37.711"
    ]
  },
  "cpu_throttle_total": {
    "labels": [
      "00:00:00"
    ],
    "datasets": [
      1
    ],
    "timestamps": [
      "2021-07-14 14:17:37.711"
    ]
  },
  "mem": {
    "labels": [
      "00:00:00"
    ],
    "datasets": [
      1
    ],
    "timestamps": [
      "2021-07-14 14:17:37.711"
    ]
  },
  "network": {
    "receive": {
      "labels": [
        "00:00:00"
      ],
      "datasets": [
        1
      ],
      "timestamps": [
        "2021-07-14 14:17:37.711"
      ]
    },
    "transmit": {
      "labels": [
        "00:00:00"
      ],
      "datasets": [
        1
      ],
      "timestamps": [
        "2021-07-14 14:17:37.711"
      ]
    }
  }
}

🗺️ Private Fleets

Deploy to Fleet

post

[Rate Limit: 40/seconds] Initiate a new private fleet deployment. A deployment is a containerized server instance of an application version running on the Edgegap platform.

Authorizations

apiKey1

AuthorizationstringRequired

Manage API tokens in dashboard.

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

application/json

private_host_idsstring[] · min: 1Required

Preferred and prioritized Private Host IDs to try before overflowing to cloud.

Example: alpha-north-america-95fab093

applicationstringRequired

Name of the application that will be deployed

Example: my-game-server

versionstringRequired

Name of the version within the application that will be deployed

Example: 25.05.30-16.45.19-04

require_cached_locationsboolean · nullableOptional

Deploy faster by limiting placement to locations with cached image.

Default: false

tagsstring[]Optional

List of tags to associate with the deployment

Example: my-custom-tag

Responses

202Success

application/json

400

Invalid Application or Application Version. No deployment has been created

application/json

401

Unauthorized. No deployment has been created.

application/json

422

Could not allocate an Edge Server for the deployment. A deployment has been created. Deployment is in error state. You can delete it manually or it will be deleted automatically by our system after some some times

application/json

500

Internal Server Error

application/json

post

/private-fleets/deployments

HTTPcURLJavaScriptPython

POST /v2/private-fleets/deployments HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 651

{
  "private_host_ids": [
    "alpha-north-america-95fab093"
  ],
  "application": "my-game-server",
  "version": "25.05.30-16.45.19-04",
  "resources": {
    "cpu_units": 1536,
    "memory_mib": 3072
  },
  "require_cached_locations": false,
  "users": [
    {
      "user_type": "ip_address",
      "user_data": {
        "ip_address": "75.28.35.192"
      }
    },
    {
      "user_type": "geo_coordinates",
      "user_data": {
        "latitude": 45.508888,
        "longitude": -73.561668
      }
    }
  ],
  "environment_variables": [
    {
      "key": "MY_ENVIRONMENT_VARIABLE",
      "value": "my-value",
      "is_hidden": false
    }
  ],
  "tags": [
    "my-custom-tag"
  ],
  "webhook_on_ready": {
    "url": "https://my-webhook.com"
  },
  "webhook_on_error": {
    "url": "https://my-webhook.com"
  },
  "webhook_on_terminated": {
    "url": "https://my-webhook.com"
  }
}

{
  "request_id": "a69f8e3e0555"
}

List Private Fleet Hosts

get

[Rate Limit: 10/seconds] List all hosts in a private fleet.

Authorizations

apiKey1

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

fleet-namestringRequired

Name of your private fleet.

Example: test-fleet

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200Success

application/json

total_countintegerRequiredExample: 100

400Error

application/json

401Error

application/json

500Error

application/json

get

/private-fleets/{fleet-name}/hosts

HTTPcURLJavaScriptPython

GET /v2/private-fleets/{fleet-name}/hosts HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "host_id": "alpha-north-america-95fab093",
      "status": "ACTIVE",
      "ip_address": "192.53.120.48",
      "latitude": 43.6173,
      "longitude": -79.3186,
      "city": "Toronto",
      "country": "Canada",
      "continent": "North America",
      "allocated_cpu_units": 1152,
      "allocated_memory_mb": 2176,
      "allocatable_cpu_units": 12928,
      "allocatable_memory_mb": 25178,
      "beacon": {
        "tcp_port": 30974,
        "udp_port": 31843,
        "ip_address": "192.53.120.48"
      },
      "created_at": "2025-11-26T16:32:30.825138Z",
      "updated_at": "2025-11-26T16:32:30.825144Z",
      "centroid": {
        "label": "Alpha",
        "latitude": 43.98884323260136,
        "longitude": -78.67419552556069,
        "radius_km": 1,
        "desired_host_count": 1
      },
      "delete_schedule": {
        "uuid": "10287c9b-a6e2-4909-84c8-59daf74895b5",
        "scheduled_at": "2025-11-30T23:59:00Z"
      },
      "fleet_host_specifications": {
        "cpu_units": 16384,
        "memory_mb": 32768,
        "base_clock_speed_mhz": 2000
      }
    }
  ],
  "total_count": 100,
  "pagination": {
    "number": 1,
    "next_page_number": 2,
    "previous_page_number": 1,
    "paginator": {
      "num_pages": 10
    },
    "has_next": true,
    "has_previous": false
  }
}

🔖 Tags

Create Tag

post

Create a tag for the specified deployment. Does not modify injected variables in a running deployment.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: f68e011bfb01

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

application/json

namestring · min: 1 · max: 40Required

Name of the tag.

Example: development

Responses

200

Success

application/json

namestring · min: 1 · max: 40Required

Name of the tag.

Example: development

create_timestring · date-timeOptional

Date of creation.

Example: 2026-04-22 20:30:52.283949

last_updatedstring · date-timeOptional

Date of last update.

Example: 2026-04-22 20:30:52.283949

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

post

/v1/deployments/{deployment_id}/tags

HTTPcURLJavaScriptPython

POST /v1/deployments/{deployment_id}/tags HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "name": "development"
}

{
  "name": "development",
  "create_time": "2026-04-22 20:30:52.283949",
  "last_updated": "2026-04-22 20:30:52.283949"
}

Get Tag

get

Get tag from the specified deployment.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: f68e011bfb01

tag_namestringRequiredExample: player-id-1234

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

namestring · min: 1 · max: 40Required

Name of the tag.

Example: development

create_timestring · date-timeOptional

Date of creation.

Example: 2026-04-22 20:30:52.283949

last_updatedstring · date-timeOptional

Date of last update.

Example: 2026-04-22 20:30:52.283949

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/deployments/{deployment_id}/tags/{tag_name}

HTTPcURLJavaScriptPython

GET /v1/deployments/{deployment_id}/tags/{tag_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "name": "development",
  "create_time": "2026-04-22 20:30:52.283949",
  "last_updated": "2026-04-22 20:30:52.283949"
}

List Tags

get

List tags from the specified deployment.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: f68e011bfb01

Query parameters

pageinteger · min: 1OptionalExample: 2

limitinteger · min: 1OptionalExample: 20

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

total_countintegerRequiredExample: 100

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/deployments/{deployment_id}/tags

HTTPcURLJavaScriptPython

GET /v1/deployments/{deployment_id}/tags HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "tags": [
    {
      "name": "development",
      "create_time": "2026-04-22 20:30:52.283949",
      "last_updated": "2026-04-22 20:30:52.283949"
    }
  ],
  "total_count": 100,
  "pagination": {
    "number": 1,
    "next_page_number": 2,
    "previous_page_number": 1,
    "paginator": {
      "num_pages": 10
    },
    "has_next": true,
    "has_previous": false
  }
}

Update Tag

patch

Update a tag for the specified deployment. Does not modify injected variables.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: f68e011bfb01

tag_namestringRequiredExample: player-id-1234

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

application/json

namestring · min: 1 · max: 40Required

Name of the tag.

Example: development

Responses

200

Success

application/json

namestring · min: 1 · max: 40Required

Name of the tag.

Example: development

create_timestring · date-timeOptional

Date of creation.

Example: 2026-04-22 20:30:52.283949

last_updatedstring · date-timeOptional

Date of last update.

Example: 2026-04-22 20:30:52.283949

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

patch

/v1/deployments/{deployment_id}/tags/{tag_name}

HTTPcURLJavaScriptPython

PATCH /v1/deployments/{deployment_id}/tags/{tag_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "name": "development"
}

{
  "name": "development",
  "create_time": "2026-04-22 20:30:52.283949",
  "last_updated": "2026-04-22 20:30:52.283949"
}

Delete Tag

delete

Delete a tag for a deployment. Does not modify injected variables.

Authorizations

apiKey

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

deployment_idstringRequiredExample: f68e011bfb01

tag_namestringRequiredExample: player-id-1234

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

204

No Content

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete

/v1/deployments/{deployment_id}/tags/{tag_name}

HTTPcURLJavaScriptPython

DELETE /v1/deployments/{deployment_id}/tags/{tag_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

No content