MCP Gateway

Authorization

User API Key

AuthorizationBearer <token>

User API key (mgw_usr_live_* or mgw_usr_test_*)

In: header

access_token?|

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Image name in registry format (e.g. mcpgateway/sandbox-python:3.12)

Match^[a-z0-9][a-z0-9._/\-]+:[a-z0-9._\-]+$

Length1 <= length <= 255

display_name*string

Human-readable display name

Length1 <= length <= 255

description*string

Description of the image (minimum 10 characters)

Length10 <= length

language?|

Programming language this image supports (e.g. python, node)

template?|

Template used: anthropic-skills, data-science, blank

base_image?|

Docker base image (e.g. python:3.12-slim)

packages?|

Structured packages: {"pip": [...], "npm": [...], "apt": [...]}

dockerfile?|

Dockerfile content (auto-generated if packages provided)

default_memory_mb?integer

Default memory limit in MB

Default512

Range128 <= value <= 8192

default_cpu_cores?number

Default CPU core limit

Default1

Range0.25 <= value <= 8

default_disk_mb?integer

Default disk limit in MB

Default1024

Range256 <= value <= 10240

default_network_enabled?boolean

Whether sandboxes from this image have network access by default

Defaultfalse

build_status?|

Initial build status: "pending" (default) or "ready" for pre-built images

Response Body

`application/json`

curl -X POST "https://loading/api/v1/admin/sandbox-images" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "display_name": "string",    "description": "stringstri"  }'

{
  "id": "string",
  "name": "string",
  "display_name": "string",
  "description": "string",
  "language": "string",
  "template": "string",
  "base_image": "string",
  "packages": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  },
  "is_default": false,
  "dockerfile": "string",
  "build_status": "string",
  "build_log": "string",
  "image_size_mb": 0,
  "default_memory_mb": 0,
  "default_cpu_cores": 0,
  "default_disk_mb": 0,
  "default_network_enabled": false,
  "warm_pool_min": 0,
  "warm_pool_max": 10,
  "is_active": true,
  "instance_count": 0,
  "created_by": "string",
  "created_by_name": "string",
  "created_at": "string",
  "updated_at": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Create Image

Authorization

Cookie Parameters

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`