UpsertCustomWorkflowActionInput
Input for creating a custom action, or fully overwriting one when id is supplied. Unlike updateCustomWorkflowAction, omitted optional fields are written as null.
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.
nameString!Machine-readable slug, unique per tenant. Must match ^[a-z][a-z0-9_-]{0,63}$.
labelString!Human-readable display name shown in the UI. Required.
descriptionStringOptional tooltip / documentation text, max 1000 characters. On update, null clears any existing text.
iconStringOptional 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.
pinToCurrentScriptBooleanTrue 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).
configSchemaStringOptional JSON Schema document (as a JSON string) for the action's configuration. Null clears it.
isActiveBooleanSoft enable/disable toggle. Omitted keeps the existing value on overwrite, and defaults to true when creating.
View exact 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
}One stable address across all schema views. Follow a field’s type to explore connections between domains.