Skip to main content
GET
Get 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>.

Path Parameters

app_name
string
required

Fly App Name

Response

200 - application/json

OK

id
string

Unique ID of the app, as used by Fly.io's GraphQL API.

internal_numeric_id
integer

Fly.io's internal numeric ID of the app.

machine_count
integer

Number of the app's Machines that have not been destroyed.

name
string

Globally unique name of the app.

network
string

Name of the private network the app is attached to: default for the organization's default network, or the name given when the app was created.

network_cidr
string

The /48 IPv6 prefix of the private (6PN) network the app is attached to, such as fdaa:0:1234::/48. Apps on the same network share it.

organization
object

The organization that owns the app.

status
enum<string>

State of the app. pending until one of its Machines changes state. After that, updated asynchronously whenever a Machine changes state: deployed if at least one Machine is started, and suspended otherwise.

Available options:
pending,
deployed,
suspended
volume_count
integer

Number of the app's volumes that have not been destroyed or scheduled for destruction.