← API reference
Mutation / scripting

upsertCustomWorkflowAction

Create a custom action, or overwrite an existing one when input.id is supplied. Overwrite semantics: omitted optional fields are written as null, unlike updateCustomWorkflowAction. Requires customWorkflowAction:write permission.

Arguments

The action to write. With an id, the existing action is overwritten in place; without one, a new action is created.

Returns UpsertCustomWorkflowActionPayload!

Explore in a view

Scripting
View exact SDL
"""
Create a custom action, or overwrite an existing one when input.id is supplied. Overwrite semantics: omitted optional fields are written as null, unlike updateCustomWorkflowAction. Requires customWorkflowAction:write permission.
"""
upsertCustomWorkflowAction(
  """
  The action to write. With an id, the existing action is overwritten in place; without one, a new action is created.
  """
  input: UpsertCustomWorkflowActionInput!
): UpsertCustomWorkflowActionPayload! @topic(names: ["scripting"])

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