← All types
In Input object

UpsertCustomWorkflowActionInput

Input for creating a custom action, or fully overwriting one when id is supplied. Unlike updateCustomWorkflowAction, omitted optional fields are written as null.

Fields

TypeID (prefix cac) of the action to overwrite. Omit to create a new action; supplying an id that does not exist in this tenant is an error.

name

String!Required

Machine-readable slug, unique per tenant. Must match ^[a-z][a-z0-9_-]{0,63}$.

label

String!Required

Human-readable display name shown in the UI. Required.

Optional tooltip / documentation text, max 1000 characters. On update, null clears any existing text.

icon

StringOptional

Optional Lucide icon name, max 64 characters. On update, null clears any existing icon.

TypeID (prefix scr) of the Script implementing the action. Must reference a script in this tenant.

True snapshots the script's current source into pinnedScriptContent, freezing the action against later script edits. False clears the pin. Omitted leaves an existing pin untouched (and pins nothing on create).

Optional JSON Schema document (as a JSON string) for the action's configuration. Null clears it.

Soft enable/disable toggle. Omitted keeps the existing value on overwrite, and defaults to true when creating.

Referenced by (1)
Exact type SDL
"""
Input for creating a custom action, or fully overwriting one when id is supplied. Unlike updateCustomWorkflowAction, omitted optional fields are written as null.
"""
input UpsertCustomWorkflowActionInput {
  """
  TypeID (prefix `cac`) of the action to overwrite. Omit to create a new action; supplying an id that does not exist in this tenant is an error.
  """
  id: CustomWorkflowActionID
  """
  Machine-readable slug, unique per tenant. Must match `^[a-z][a-z0-9_-]{0,63}$`.
  """
  name: String!
  """Human-readable display name shown in the UI. Required."""
  label: String!
  """
  Optional tooltip / documentation text, max 1000 characters. On update, null clears any existing text.
  """
  description: String
  """
  Optional Lucide icon name, max 64 characters. On update, null clears any existing icon.
  """
  icon: String
  """
  TypeID (prefix `scr`) of the Script implementing the action. Must reference a script in this tenant.
  """
  scriptId: ScriptID!
  """
  True snapshots the script's current source into pinnedScriptContent, freezing the action against later script edits. False clears the pin. Omitted leaves an existing pin untouched (and pins nothing on create).
  """
  pinToCurrentScript: Boolean
  """
  Optional JSON Schema document (as a JSON string) for the action's configuration. Null clears it.
  """
  configSchema: String
  """
  Soft enable/disable toggle. Omitted keeps the existing value on overwrite, and defaults to true when creating.
  """
  isActive: Boolean
}