← API reference
CANONICAL TYPE REFERENCE

UpsertDataClipInput

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

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.

nameString!

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.

View exact 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!
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.