Skip to main content

CreateAppInput

Input payload for creating a new app.

input CreateAppInput {
  orgId: BigInt!
  name: String!
  slug: String!
  datacenter: String!
  description: String
  visibility: AppVisibility
  status: AppStatus
  metadata: String
}

Fields​

CreateAppInput.orgId ● BigInt! non-null scalar​

Numeric id of the organization that will own the app. The caller must hold the manage_apps permission on this org.

CreateAppInput.name ● String! non-null scalar​

Display name of the app (1-256 characters).

CreateAppInput.slug ● String! non-null scalar​

URL-safe slug (1-128 chars, lowercase letters, numbers and dashes only). Must be unique within the org.

CreateAppInput.datacenter ● String! non-null scalar​

Datacenter the app will live in, e.g. 'or' or 'va'. Query placeableDatacenters for the accepted codes and whether each can currently hold an app. REQUIRED and permanent: an app is distributed on app_id, so all of its data lives on one node in one datacenter and that is fixed when the id is minted. Creation FAILS if the datacenter is unknown to this deployment or holds no capacity, rather than creating an app that cannot be routed. There is no default — the instance answering this call may be in a different datacenter from the one you want. Moving an app afterwards is an operator action.

CreateAppInput.description ● String scalar​

Optional short plain-text description for listings.

CreateAppInput.visibility ● AppVisibility enum​

Optional initial visibility. Defaults to PUBLIC when omitted.

CreateAppInput.status ● AppStatus enum​

Optional initial lifecycle status. Defaults to LIVE when omitted.

CreateAppInput.metadata ● String scalar​

Optional JSON-encoded marketplace metadata string (see App.metadata). Defaults to an empty object when omitted.

Member Of​

createApp mutation