Skip to main content
POST
Create App

Authorizations

Authorization
string
header
required

A Fly API token with access to the requested organization or resource. Send it as Authorization: Bearer <Fly API token>.

Body

application/json

App body

enable_subdomains
boolean

Request a wildcard TLS certificate for *.svc..fly.dev. Defaults to false. Certificate provisioning is asynchronous; this does not create services or configure their routing.

idempotency_key
string

When set, makes a retry of this exact request safe: a second create with the same key and the same name (or no name) returns the app the first request created, instead of erroring on a false name conflict or creating a duplicate. A second create with the same key but a different name is rejected outright; it won't silently hand back the first app.

name
string

Globally unique name for the app. Required.

network
string

Name of the organization's private network to attach the app to. Creates the network if it does not exist. Omit, use an empty string, or use "default" to select the organization's default network.

org_slug
string

Slug of the organization that will own the app, or "personal" for your personal organization. Required.

Response

Created

created_at
integer
id
string