← API reference
Mutation / integrations

publishIntegration

Make a version the integration's current version — the default for new installs. Existing instances are never moved. Requires integration:write permission.

Arguments

TypeID of the integration (prefix igr)

TypeID of the version to make current (prefix igd). A DRAFT is validated and promoted to ACTIVE; an ACTIVE version is a rollback or roll-forward; DEPRECATED is refused.

Returns IntegrationPayload!

Explore in a view

Integrations
View exact SDL
"""
Make a version the integration's current version — the default for new installs. Existing instances are never moved. Requires integration:write permission.
"""
publishIntegration(
  """TypeID of the integration (prefix `igr`)"""
  id: IntegrationID!
  """
  TypeID of the version to make current (prefix `igd`). A DRAFT is validated and promoted to ACTIVE; an ACTIVE version is a rollback or roll-forward; DEPRECATED is refused.
  """
  versionId: IntegrationDefinitionID!
): IntegrationPayload! @topic(names: ["integrations"])

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