Magidoc

UpdateActionsInput
Input Object

Shared patch for updateActions. At least one optional field must be set. Omitted fields are left unchanged; explicit null clears nullable fields that support it (projectId, parentId, priorityLevelId, deadline, scheduledDate, snoozeDate, type, agileSprintId, teamAssignee, layout).

Fields

#

actionColor

Hex only (e.g. #1A42CF). Prefer default palette: #1A42CF #A55EFF #56B68B #00D8D6 #FA8273 #F9AC6E #FFCF55. Color names like blue are invalid.

actionIds

[ID !]!
Non-null

agileSprintId

Pass null to clear sprint assignment.

archived

assignees

[ID !]

Replace assignees (SET). Mutually exclusive with assigneesToAdd/assigneesToPull. Pass [] or a single none value to unassign.

assigneesToAdd

[ID !]

Add assignees incrementally (ADD). Mutually exclusive with assignees (SET).

assigneesToPull

[ID !]

Remove assignees incrementally (REMOVE). Mutually exclusive with assignees (SET).

customFields

Each entry updates one custom field across all actionIds. FieldId-only (no value) clears that field.

deadline

Pass null to clear; omit to leave unchanged.

description

HTML description. Empty string clears. Prefer markdownDescription from Buzz.

githubBranchNames

Non-null list only; omit to leave unchanged. Pass [] to clear.

gitlabBranchNames

Non-null list only; omit to leave unchanged. Pass [] to clear.

labels

[ID !]

Full label replace (SET). Mutually exclusive with labelsToAdd/labelsToPull. Pass [] or a single none value to clear. An id that was never a label of the workspace fails the whole patch with "Labels do not exist or were deleted: " before any field is written. Deleted labels are left out instead.

labelsToAdd

[ID !]

Add labels incrementally (ADD). Mutually exclusive with labels (SET). Rejects or leaves out ids the same way as labels (SET).

labelsToPull

[ID !]

Remove labels incrementally (REMOVE). Mutually exclusive with labels (SET). Accepts deleted label ids, so a stale one can be cleared.

layout

Update card layout settings. Pass [] in hiddenSections to show all sections; omit sectionOrder to preserve ordering or pass [] to reset it. Pass null layout to restore the default layout, or omit layout to leave unchanged.

lockDates

Lock or unlock action dates.

markdownDescription

milestone

parentId

Nest under parent; null promotes to top-level. Applied per actionId.

placeholderAssignees

[ID !]

Replace placeholder assignees (SET). Mutually exclusive with placeholderAssigneesToAdd/ToPull. Pass [] or none to clear.

placeholderAssigneesToAdd

[ID !]

Add placeholder assignees. Mutually exclusive with placeholderAssignees (SET).

placeholderAssigneesToPull

[ID !]

Remove placeholder assignees. Mutually exclusive with placeholderAssignees (SET).

priorityLevelId

Pass null to unset priority.

progress

Gantt percent-complete fraction 0–1 (e.g. 0.4 = 40%). Values outside that range are rejected.

projectId

Pass null to unset project.

scheduledDate

Maps to action scheduledDate / start date. Pass null to clear; omit to leave unchanged.

shouldUpdateChildren

When status is set, defaults to true (cascade to subactions).

snoozeDate

Pass null to unsnooze the current user.

status

Non-empty when provided. Empty/whitespace is rejected.

storyPoints

teamAssignee

Assign a team. Pass null to clear; omit to leave unchanged.

title

Non-empty when provided. Empty/whitespace is rejected (underlying title bulk skips empties).

type

Pass null to reset to default action type (also updates isRisk for RAID types).

urgent

true marks the actions urgent; false clears urgent.

workspaceId

ID !
Non-null

Usages

#

References

#

  • Argument input of field updateActions from type Mutation