← All types
Apps & SurfacesIn Input object

UpsertDataClipInput

Input for upsertDataClip: creates a clip when id is omitted, otherwise fully overwrites the named fields of the existing clip.

Fields

id

DataClipIDOptional

TypeID of the clip to update (e.g. "dcl_01K…"). Omit to create a new clip; when supplied, the clip must already exist in the current tenant.

name

String!Required

Label for the clip. Required even on update — the upsert always overwrites the stored name.

Optional note about the clip (max 1000 characters). On update, omitting it clears any existing description.

MicroSQL query the clip runs. Must be non-empty; changing it discards the clip's cached query AST.

Referenced by (1)
Exact type SDL
"""
Input for `upsertDataClip`: creates a clip when `id` is omitted, otherwise fully overwrites the named fields of the existing clip.
"""
input UpsertDataClipInput {
  """
  TypeID of the clip to update (e.g. "dcl_01K…"). Omit to create a new clip; when supplied, the clip must already exist in the current tenant.
  """
  id: DataClipID
  """
  Label for the clip. Required even on update — the upsert always overwrites the stored name.
  """
  name: String!
  """
  Optional note about the clip (max 1000 characters). On update, omitting it clears any existing description.
  """
  description: String
  """
  MicroSQL query the clip runs. Must be non-empty; changing it discards the clip's cached query AST.
  """
  queryString: String!
}