← API reference
Mutation / apps

saveAPIClientDefinition

Create or replace an API definition and compile its types without I/O. Updates require the current revision. Compilation failures are saved with diagnostics.

Arguments

API client definition identity.

expectedRevisionString

Current definition revision; required for updates and deletion.

API definition to create or replace.

Returns SaveAPIClientDefinitionPayload!

Explore in a view

App Authoring
View exact SDL
"""
Create or replace an API definition and compile its types without I/O. Updates require the current revision. Compilation failures are saved with diagnostics.
"""
saveAPIClientDefinition(
  """API client definition identity."""
  id: APIClientDefinitionID
  """Current definition revision; required for updates and deletion."""
  expectedRevision: String
  """API definition to create or replace."""
  input: APIClientDefinitionInput!
): SaveAPIClientDefinitionPayload! @topic(names: ["apps"])

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