Версионирование

📦 Приложения и версии

Create App

post

Create an app to group versions and/or split environments.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

namestring · min: 3 · max: 64Required

Custom identifier.

Example: my-game-server

is_activebooleanRequired

Enable or disable deployments.

Default: trueExample: true

imagestringRequired

Image base64 string.

Example: iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==

Responses

200

Success

application/json

namestring · min: 3 · max: 64Required

Custom name.

Example: my-game-server

is_activebooleanRequired

Enable or disable deployments.

Default: trueExample: true

imagestringRequired

Image base64 string.

Example: iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==

create_timestringRequired

Date of creation.

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

last_updatedstringRequired

Date of last update.

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

400

Bad Request

application/json

401

Unauthorized

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

post

/v1/app

POST /v1/app HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "name": "my-game-server",
  "is_active": true,
  "image": "iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg=="
}

{
  "name": "my-game-server",
  "is_active": true,
  "image": "iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==",
  "create_time": "2026-04-22 12:00:46.444265",
  "last_updated": "2026-04-22 12:00:46.444265"
}

Get App

get

Get app details.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestringRequiredExample: my-game-server

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

namestring · min: 3 · max: 64Required

Custom name.

Example: my-game-server

is_activebooleanRequired

Enable or disable deployments.

Default: trueExample: true

imagestringRequired

Image base64 string.

Example: iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==

create_timestringRequired

Date of creation.

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

last_updatedstringRequired

Date of last update.

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

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/app/{app_name}

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

{
  "name": "my-game-server",
  "is_active": true,
  "image": "iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==",
  "create_time": "2026-04-22 12:00:46.444265",
  "last_updated": "2026-04-22 12:00:46.444265"
}

List Apps

get

List apps under your organization.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

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

400Error

application/json

401

Unauthorized

application/json

403Error

application/json

500

Internal Server Error

application/json

get

/v1/apps

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

{
  "applications": [
    {
      "name": "my-game-server",
      "is_active": true,
      "image": "iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==",
      "create_time": "2026-04-22 12:00:46.444265",
      "last_updated": "2026-04-22 12:00:46.444265"
    }
  ],
  "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 App

patch

Modify existing app.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestringRequiredExample: my-game-server

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

namestring · min: 3 · max: 64Optional

Application name

Example: my-game-server

is_activebooleanOptional

If the application can be deployed

Default: trueExample: true

imagestringOptional

Image base64 string

Example: iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==

Responses

200

Success

application/json

namestring · min: 3 · max: 64Required

Custom name.

Example: my-game-server

is_activebooleanRequired

Enable or disable deployments.

Default: trueExample: true

imagestringRequired

Image base64 string.

Example: iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==

create_timestringRequired

Date of creation.

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

last_updatedstringRequired

Date of last update.

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

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/app/{app_name}

PATCH /v1/app/{app_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "name": "my-game-server",
  "is_active": true,
  "image": "iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg=="
}

{
  "name": "my-game-server",
  "is_active": true,
  "image": "iVBORw0KGgoAAAANSUhEUg[...]AAABJRU5ErkJggg==",
  "create_time": "2026-04-22 12:00:46.444265",
  "last_updated": "2026-04-22 12:00:46.444265"
}

Delete App

delete

Delete an app and its versions.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestringRequiredExample: my-game-server

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

No content

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete

/v1/app/{app_name}

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

No content

Create App Version

post

Create an app version.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestring · min: 3 · max: 64RequiredExample: my-game-server

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

namestring · min: 1 · max: 64Required

Custom version identifier, often a timestamp or a build ID.

Example: 2024.01.30-16.23.00-UTC

is_activebooleanOptional

Enable or disable deployments.

Default: trueExample: true

req_cpuinteger · min: 100Required

Amount of vCPU units assigned to deployments. (1024 units = 1 vCPU).

Example: 1536

req_memoryinteger · min: 100Required

Amount of memory MB assigned to deployments, at most double your vCPU units. (1024 MB = 1 GB).

Example: 3072

req_videointegerOptional

Amount of GPU units assigned to deployments. (1024 = 1 GPU)

Example: 0

docker_repositorystringRequired

Docker registry URL, ‘docker_repository’ is named incorrectly.

Example: registry.edgegap.com

private_usernamestringOptional

Docker Registry username. Not your Edgegap credentials.

Example: robot$my-org-cv2l3w3vy6fg+app-version-pull

private_tokenstringOptional

Docker Registry token/password. Not your Edgegap credentials.

Example: ghca3dz3foAxXf2tu2xjExtXrBOMydfC

docker_imagestringRequired

Namespaced docker image ID.

Example: my-org-cv2l3w3vy6fg/my-game-server

docker_tagstringRequired

Docker tag ID, typically timestamp or a build ID. Avoid using latest or overwriting tags.

Example: 2024.01.30-16.23.00-UTC

verify_imagebooleanOptional

Enable to verify we can pull your docker image using provided parameters and credentials.

Default: falseExample: true

force_cachebooleanOptional

Enable faster deployments with global image preloading. Recommended for live games.

Example: true

time_to_deployinteger · min: 15Optional

Image downloads exceeding this period (seconds) will timeout and be marked as Error.

Default: 10Example: 10

max_durationinteger · min: -1 · max: 1440Optional

Maximum allowed uptime minutes of deployments before automatically stopped.

Default: 1440Example: 1440

restart_policystring · enumOptional

Define policy for handling server process exit codes. Set to never to automatically stop deployments when your server process exits.

Default: alwaysExample: neverPossible values:

termination_grace_period_secondsinteger · min: 5 · max: 3600Optional

Termination grace period in seconds after sending the SIGTERM signal to your deployment. Allows graceful shutdown and post-processing before the container stops.

Example: 5

will_deploy_in_mainland_chinabooleanOptional

Enable China Gateway. Disable to deploy worldwide except China.

Default: false

dns_configstringOptional

DNS configuration identifier for custom deployment domains.

Example: my-dns-config

endpoint_storagestringOptional

Endpoint storage identifier to upload deployment logs, overrides app version storage if specified.

Example: my-storage

Responses

200

Success

application/json

successbooleanRequired

If the creation happened correctly

Default: true

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

409

Conflict

application/json

424

Failed Dependency

application/json

500

Internal Server Error

application/json

post

/v1/app/{app_name}/version

POST /v1/app/{app_name}/version HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 417

{
  "name": "2024.01.30-16.23.00-UTC",
  "req_cpu": 1536,
  "req_memory": 3072,
  "docker_repository": "registry.edgegap.com",
  "private_username": "robot$my-org-cv2l3w3vy6fg+app-version-pull",
  "private_token": "ghca3dz3foAxXf2tu2xjExtXrBOMydfC",
  "docker_image": "my-org-cv2l3w3vy6fg/my-game-server",
  "docker_tag": "2024.01.30-16.23.00-UTC",
  "ports": [
    {
      "port": 7777,
      "protocol": "UDP",
      "to_check": false,
      "name": "gameport"
    }
  ],
  "restart_policy": "never"
}

{
  "success": true,
  "version": {
    "name": "2024.01.30-16.23.00-UTC",
    "create_time": "2026-04-22 20:30:52.283949",
    "last_updated": "2026-04-22 20:30:52.283949",
    "is_active": true,
    "req_cpu": 1536,
    "req_memory": 3072,
    "docker_repository": "docker.io",
    "private_username": "robot$my-org-cv2l3w3vy6fg+app-version-pull",
    "private_token": "ghca3dz3foAxXf2tu2xjExtXrBOMydfC",
    "docker_image": "my-org-cv2l3w3vy6fg/my-game-server",
    "docker_tag": "2024.01.30-16.23.00-UTC",
    "verify_image": false,
    "force_cache": false,
    "caching_percent": 0.8,
    "time_to_deploy": 30,
    "max_duration": 60,
    "termination_grace_period_seconds": 5,
    "ports": [
      {
        "port": 7777,
        "protocol": "UDP",
        "to_check": false,
        "tls_upgrade": false,
        "name": "gameport"
      }
    ],
    "envs": []
  }
}

Get App Version

get

Get version details.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestringRequired

The name of the application

Example: my-game-server

version_namestringRequired

The name of the application version

Example: 2024.01.30-16.23.00-UTC

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

namestring · min: 1 · max: 64Required

Custom version identifier, often a timestamp or a build ID.

Example: 2024.01.30-16.23.00-UTC

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

is_activebooleanOptional

Enable or disable deployments.

Default: trueExample: true

req_cpuinteger · min: 100Required

Amount of vCPU units assigned to deployments. (1024 units = 1 vCPU).

Example: 1536

req_memoryinteger · min: 100Required

Amount of memory MB assigned to deployments, at most double your vCPU units. (1024 MB = 1 GB).

Example: 3072

req_videointegerOptional

Amount of GPU units assigned to deployments. (1024 = 1 GPU)

Example: 0

docker_repositorystringRequired

Docker registry URL, ‘docker_repository’ is named incorrectly.

Example: registry.edgegap.com

private_usernamestringOptional

Docker Registry username. Not your Edgegap credentials.

Example: robot$my-org-cv2l3w3vy6fg+app-version-pull

private_tokenstringOptional

Docker Registry token/password. Not your Edgegap credentials.

Example: ghca3dz3foAxXf2tu2xjExtXrBOMydfC

docker_imagestringRequired

Namespaced docker image ID.

Example: my-org-cv2l3w3vy6fg/my-game-server

docker_tagstringRequired

Docker tag ID, typically timestamp or a build ID. Avoid using latest or overwriting tags.

Example: 2024.01.30-16.23.00-UTC

verify_imagebooleanOptional

Enable to verify we can pull your docker image using provided parameters and credentials.

Default: falseExample: true

force_cachebooleanOptional

Enable faster deployments with global image preloading. Recommended for live games.

Example: true

caching_percentnumberOptional

Current global caching percentage on scale 0-1. Values above 0.8 (80%) are considered a good coverage level.

Example: 0.8

time_to_deployinteger · min: 15Optional

Image downloads exceeding this period (seconds) will timeout and be marked as Error.

Default: 10Example: 10

max_durationinteger · min: -1 · max: 1440Optional

Maximum allowed uptime minutes of deployments before automatically stopped.

Default: 1440Example: 1440

restart_policystring · enumOptional

Define policy for handling server process exit codes. Set to never to automatically stop deployments when your server process exits.

Default: alwaysExample: neverPossible values:

termination_grace_period_secondsinteger · min: 5 · max: 3600Optional

Termination grace period in seconds after sending the SIGTERM signal to your deployment. Allows graceful shutdown and post-processing before the container stops.

Example: 5

will_deploy_in_mainland_chinabooleanOptional

Enable China Gateway. Disable to deploy worldwide except China.

Default: false

dns_configstringOptional

DNS configuration identifier for custom deployment domains.

Example: my-dns-config

endpoint_storagestringOptional

Endpoint storage identifier to upload deployment logs, overrides app version storage if specified.

Example: my-storage

400Error

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/app/{app_name}/version/{version_name}

GET /v1/app/{app_name}/version/{version_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "name": "2024.01.30-16.23.00-UTC",
  "create_time": "2026-04-22 20:30:52.283949",
  "last_updated": "2026-04-22 20:30:52.283949",
  "is_active": true,
  "req_cpu": 1536,
  "req_memory": 3072,
  "req_video": 0,
  "docker_repository": "registry.edgegap.com",
  "private_username": "robot$my-org-cv2l3w3vy6fg+app-version-pull",
  "private_token": "ghca3dz3foAxXf2tu2xjExtXrBOMydfC",
  "docker_image": "my-org-cv2l3w3vy6fg/my-game-server",
  "docker_tag": "2024.01.30-16.23.00-UTC",
  "verify_image": true,
  "force_cache": true,
  "caching_percent": 0.8,
  "time_to_deploy": 10,
  "max_duration": 1440,
  "restart_policy": "never",
  "termination_grace_period_seconds": 5,
  "will_deploy_in_mainland_china": false,
  "dns_config": "my-dns-config",
  "ports": [
    {
      "port": 7777,
      "protocol": "UDP",
      "to_check": true,
      "tls_upgrade": false,
      "name": "gameport"
    }
  ],
  "envs": [
    {
      "key": "MM_MATCH_PROFILE",
      "value": "advanced-example",
      "is_hidden": false
    }
  ],
  "endpoint_storage": "my-storage"
}

List App Versions

get

List versions under app.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestringRequired

The name of the application

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/app/{app_name}/versions

GET /v1/app/{app_name}/versions HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "versions": [
    {
      "name": "2024.01.30-16.23.00-UTC",
      "create_time": "2026-04-22 20:30:52.283949",
      "last_updated": "2026-04-22 20:30:52.283949",
      "is_active": true,
      "req_cpu": 1536,
      "req_memory": 3072,
      "req_video": 0,
      "docker_repository": "registry.edgegap.com",
      "private_username": "robot$my-org-cv2l3w3vy6fg+app-version-pull",
      "private_token": "ghca3dz3foAxXf2tu2xjExtXrBOMydfC",
      "docker_image": "my-org-cv2l3w3vy6fg/my-game-server",
      "docker_tag": "2024.01.30-16.23.00-UTC",
      "verify_image": true,
      "force_cache": true,
      "caching_percent": 0.8,
      "time_to_deploy": 10,
      "max_duration": 1440,
      "restart_policy": "never",
      "termination_grace_period_seconds": 5,
      "will_deploy_in_mainland_china": false,
      "dns_config": "my-dns-config",
      "ports": [
        {
          "port": 7777,
          "protocol": "UDP",
          "to_check": true,
          "tls_upgrade": false,
          "name": "gameport"
        }
      ],
      "envs": [
        {
          "key": "MM_MATCH_PROFILE",
          "value": "advanced-example",
          "is_hidden": false
        }
      ],
      "endpoint_storage": "my-storage"
    }
  ],
  "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 App Version

patch

Modify existing app version.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestringRequired

The name of the application

Example: my-game-server

version_namestringRequired

The name of the application version

Example: 2024.01.30-16.23.00-UTC

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

namestring · min: 1 · max: 64Optional

Custom version identifier, often a timestamp or a build ID.

Example: 2024.01.30-16.23.00-UTC

is_activebooleanOptional

Enable or disable deployments.

Default: trueExample: true

docker_repositorystringOptional

Docker registry URL, ‘docker_repository’ is named incorrectly.

Example: registry.edgegap.com

private_usernamestringOptional

Docker Registry username. Not your Edgegap credentials.

Example: robot$my-org-cv2l3w3vy6fg+app-version-pull

private_tokenstringOptional

Docker Registry token/password. Not your Edgegap credentials.

Example: ghca3dz3foAxXf2tu2xjExtXrBOMydfC

docker_imagestringOptional

Namespaced docker image ID.

Example: my-org-cv2l3w3vy6fg/my-game-server

docker_tagstringOptional

Docker tag ID, typically timestamp or a build ID. Avoid using latest or overwriting tags.

Example: 2024.01.30-16.23.00-UTC

verify_imagebooleanOptional

Enable to verify we can pull your docker image using provided parameters and credentials.

Default: falseExample: true

force_cachebooleanOptional

Enable faster deployments with global image preloading. Recommended for live games.

Example: true

time_to_deployinteger · min: 15Optional

Image downloads exceeding this period (seconds) will timeout and be marked as Error.

Default: 10Example: 10

max_durationinteger · min: -1 · max: 1440Optional

Maximum allowed uptime minutes of deployments before automatically stopped.

Default: 1440Example: 1440

restart_policystring · enumOptional

Define policy for handling server process exit codes. Set to never to automatically stop deployments when your server process exits.

Default: alwaysExample: neverPossible values:

termination_grace_period_secondsinteger · min: 5 · max: 3600Optional

Termination grace period in seconds after sending the SIGTERM signal to your deployment. Allows graceful shutdown and post-processing before the container stops.

Example: 5

will_deploy_in_mainland_chinabooleanOptional

Enable China Gateway. Disable to deploy worldwide except China.

Default: false

dns_configstringOptional

DNS configuration identifier for custom deployment domains.

Example: my-dns-config

endpoint_storagestringOptional

Endpoint storage identifier to upload deployment logs, overrides app version storage if specified.

Example: my-storage

Responses

200

Success

application/json

successbooleanRequired

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

424

Failed Dependency

application/json

500

Internal Server Error

application/json

patch

/v1/app/{app_name}/version/{version_name}

PATCH /v1/app/{app_name}/version/{version_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 115

{
  "time_to_deploy": 30,
  "envs": [
    {
      "key": "MAP_ID",
      "value": "forest1",
      "is_secret": false
    }
  ],
  "endpoint_storage": "my-storage"
}

{
  "success": true,
  "version": {
    "name": "2024.01.30-16.23.00-UTC",
    "create_time": "2026-04-22 20:30:52.283949",
    "last_updated": "2026-04-22 20:30:52.283949",
    "is_active": true,
    "req_cpu": 1536,
    "req_memory": 3072,
    "req_video": 0,
    "docker_repository": "registry.edgegap.com",
    "private_username": "robot$my-org-cv2l3w3vy6fg+app-version-pull",
    "private_token": "ghca3dz3foAxXf2tu2xjExtXrBOMydfC",
    "docker_image": "my-org-cv2l3w3vy6fg/my-game-server",
    "docker_tag": "2024.01.30-16.23.00-UTC",
    "verify_image": true,
    "force_cache": true,
    "caching_percent": 0.8,
    "time_to_deploy": 10,
    "max_duration": 1440,
    "restart_policy": "never",
    "termination_grace_period_seconds": 5,
    "will_deploy_in_mainland_china": false,
    "dns_config": "my-dns-config",
    "ports": [
      {
        "port": 7777,
        "protocol": "UDP",
        "to_check": true,
        "tls_upgrade": false,
        "name": "gameport"
      }
    ],
    "envs": [
      {
        "key": "MM_MATCH_PROFILE",
        "value": "advanced-example",
        "is_hidden": false
      }
    ],
    "endpoint_storage": "my-storage"
  }
}

Delete App Version

delete

Delete an app version.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

app_namestringRequired

The name of the application

Example: my-game-server

version_namestringRequired

The name of the application version

Example: 2024.01.30-16.23.00-UTC

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

successbooleanRequired

messagestringOptional

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete

/v1/app/{app_name}/version/{version_name}

DELETE /v1/app/{app_name}/version/{version_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "message": "text"
}

💾 Реестр контейнеров

List Image Tags

get

List all tags of a specific docker image.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

image_namestringRequired

The name of the image

Example: my-org-cv2l3w3vy6fg/my-game-server

Query parameters

pageinteger · min: 1OptionalExample: 2

limitinteger · min: 1OptionalExample: 20

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

400Error

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/container-registry/images/{image_name}/tags

GET /v1/container-registry/images/{image_name}/tags HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "tag": "2024.01.30-16.23.00-UTC",
      "last_push_at": "2026-04-22 20:30:52.283949",
      "artifact": {
        "artifact_deleted": false,
        "remaining_tags": [
          "tag1",
          "tag2"
        ],
        "image_hash": "sha256:1234567890abcdef",
        "size_mb": 512
      }
    }
  ]
}

Delete Image Tag

delete

Delete a single tag and the associated image in the registry.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

image_namestringRequired

Docker image name.

Example: my-org-cv2l3w3vy6fg/my-game-server

tag_namestringRequired

Docker tag ID.

Example: 2024.01.30-16.23.00-UTC

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Responses

200

Success

application/json

deleted_tagstringOptional

Deleted docker tag ID.

Example: 1.0.0

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete

/v1/container-registry/images/{image_name}/tags/{tag_name}

DELETE /v1/container-registry/images/{image_name}/tags/{tag_name} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "artifact": {
    "artifact_deleted": true,
    "size_mb": 512,
    "remaining_tags": [
      "text"
    ],
    "image_hash": "sha256:1234567890abcdef"
  },
  "deleted_tag": "1.0.0"
}

Delete Image Tags

post

Delete multiple tags of a registry image. Returns 207 Multi-Status with result for each tag separately. Caution is advised.

Authorizations

AuthorizationstringRequired

Manage API tokens in dashboard.

Path parameters

image_namestringRequired

The name of the image

Example: my-org-cv2l3w3vy6fg/my-game-server

Header parameters

AcceptstringOptionalExample: */*

Content-TypestringOptionalExample: application/json

Body

tagsstring[]Required

Tags to delete.

Example: 1.0.0

Responses

207Success

application/json

400Error

application/json

401Error

application/json

404Error

application/json

500Error

application/json

post

/v1/container-registry/images/{image_name}/tags/bulk-delete

POST /v1/container-registry/images/{image_name}/tags/bulk-delete HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "tags": [
    "1.0.0"
  ]
}

{
  "results": [
    {
      "tag": "1.0.0",
      "status": 204,
      "message": "text"
    }
  ],
  "summary": {
    "total": 2,
    "success": 1,
    "failed": 1
  }
}

ПредыдущаяВыделенные серверы СледующаяИнтеграция

Последнее обновление 6 дней назад

Это было полезно?

hashtag📦 Приложения и версии

hashtagCreate App

hashtagGet App

hashtagList Apps

hashtagUpdate App

hashtagDelete App

hashtagCreate App Version

hashtagGet App Version

hashtagList App Versions

hashtagUpdate App Version

hashtagDelete App Version

hashtag💾 Реестр контейнеров

hashtagList Image Tags

hashtagDelete Image Tag

hashtagDelete Image Tags

📦 Приложения и версии

Create App

Get App

List Apps

Update App

Delete App

Create App Version

Get App Version

List App Versions

Update App Version

Delete App Version

💾 Реестр контейнеров

List Image Tags

Delete Image Tag

Delete Image Tags