Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Apps

Add a new app

Create a new edge application from a WebAssembly binary. The app is configured with execution limits, environment variables, and network assignments. Apps start in draft status (0) and must be explicitly enabled to receive traffic.

post/fastedge/v1/apps

Request body

namestring

Unique application name (alphanumeric, hyphens allowed)

urlstring

Auto-generated URL where the application is accessible

binaryinteger

ID of the WebAssembly binary to deploy

templateinteger

Template ID

template_namestring

Template name

statusinteger

Status code:
0 - draft (inactive)
1 - enabled
2 - disabled
5 - suspended

plan_idinteger

Plan ID

planstring

Plan name

envobject

Environment variables

rsp_headersobject

Extra headers to add to the response

log'kafka' | 'none' nullable
debugboolean

Enable verbose debug logging for 30 minutes. Automatically expires to prevent performance impact.

debug_untilstring date-time

When debugging finishes

commentstring

Optional human-readable description of the application's purpose

api_typestring

Wasm API type

networksstring[]

Networks

secretsobject

Application secrets

storesobject

Application edge stores

Example request

{
  "name": "my-edge-app",
  "url": "my-edge-app.fastedge.gcore.dev",
  "binary": 12345,
  "status": 1,
  "env": {
    "var1": "value1",
    "var2": "value2"
  },
  "rsp_headers": {
    "header1": "value1",
    "header2": "value2"
  },
  "comment": "Production API gateway for customer portal"
}

Response

Application created successfully, returns app metadata

idinteger required

App ID

namestring required

App name

urlstring

App URL

statusinteger required

Status code:
0 - draft (inactive)
1 - enabled
2 - disabled
3 - hourly call limit exceeded
4 - daily call limit exceeded
5 - suspended

binaryinteger required

Binary ID

commentstring

Description of the binary

api_typestring required

Wasm API type

debug_untilstring date-time

When debugging finishes

debugboolean

Switch on logging for 30 minutes (switched off by default)

templateinteger

Template ID

template_namestring

Template name

networksstring[]

Networks

upgradeable_tointeger

ID of the binary the app can be upgraded to

plan_idinteger required

Application plan ID

planstring

Application plan name