Monday Update

Monday Update

Certified

Update one or more column values on an item

Calls change_multiple_column_values. columnValues is serialized to a JSON string before being sent, matching Monday's JSON-in-JSON contract.

yaml
type: io.kestra.plugin.monday.items.Update

Set a status column

yaml
id: monday_update_item
namespace: company.team

tasks:
  - id: update
    type: io.kestra.plugin.monday.items.Update
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    boardId: "1234567890"
    itemId: "9876543210"
    columnValues:
      status: { label: "Done" }
Properties

Monday API token

Personal API v2 token. Generate it in Monday under Profile, Developers, My Access Tokens. Treat the token as a secret and prefer Kestra secrets, e.g. {{ secret('MONDAY_API_TOKEN') }}.

Board id of the item

Column values to set, keyed by column id

Item id to update

Defaulthttps://api.monday.com/v2

Monday GraphQL endpoint

Override only for proxies or test fixtures (WireMock).

Default2024-10

Monday API version header

Sent as the API-Version header. See the Monday API versioning docs.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
Defaultfalse

Create new label entries on status/dropdown columns when missing

Default3

Maximum retry attempts

Number of attempts before giving up on transient Monday API errors (HTTP 429, COMPLEXITY_BUDGET_EXHAUSTED).

DefaultPT5S

Initial retry interval

Base wait between retry attempts. Doubles each attempt up to maxRetryInterval.

DefaultPT30S

Maximum retry interval

Cap on the exponentially-growing retry delay.