← API reference
Mutation / apps

publishCustomApp

Publish a specific version of a custom app, making it visible to end users. Requires customapp:write permission.

Arguments

TypeID of the custom app to publish (prefix cap).

TypeID of the version to make live (prefix cav). Fails with a field error when the version is unknown or belongs to another app. Its content and engine version are copied onto the app — this is what makes it serve.

Returns UpsertCustomAppPayload!

Explore in a view

App Authoring
View exact SDL
"""
Publish a specific version of a custom app, making it visible to end users. Requires customapp:write permission.
"""
publishCustomApp(
  """TypeID of the custom app to publish (prefix `cap`)."""
  id: CustomAppID!
  """
  TypeID of the version to make live (prefix `cav`). Fails with a field error when the version is unknown or belongs to another app. Its content and engine version are copied onto the app — this is what makes it serve.
  """
  versionId: CustomAppVersionID!
): UpsertCustomAppPayload! @topic(names: ["apps"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.