← API reference
Mutation / integrations

deleteIntegrationDefinition

Delete an integration definition. The final unused version may be deleted, clearing the current version with integration:write permission. Refuses while any instance is installed from it, rather than cascading — an instance reads its definition's manifest at execution time, so removing one underneath a live integration breaks it at the next fire rather than here. Requires integrationDefinition:delete permission.

Arguments

TypeID (prefix igd) of the definition to delete.

Returns DeletePayload!

Scalar fields at a glance

successBoolean!
↗ View the complete DeletePayload type

Explore in a view

Integrations
View exact SDL
"""
Delete an integration definition. The final unused version may be deleted, clearing the current version with integration:write permission. Refuses while any instance is installed from it, rather than cascading — an instance reads its definition's manifest at execution time, so removing one underneath a live integration breaks it at the next fire rather than here. Requires integrationDefinition:delete permission.
"""
deleteIntegrationDefinition(
  """TypeID (prefix `igd`) of the definition to delete."""
  id: IntegrationDefinitionID!
): DeletePayload! @topic(names: ["integrations"])

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