Update Card
wekan.update_card
ActionBusiness appsconnection required
Calls the Wekan API with the connection's credentials.
Change one or more fields on an existing card.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Wekan
- Secret shape
- the Wekan API token as {"token": "…"}, or {"username": "…", "password": "…"} to log in with
- Config it needs
- base_url, user_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
17 fields, 3 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
board_id Wekan's id for the board. It is the long identifier in the board URL, not its title. | string | Yes | — | — | wJmnfd4bLLYAoRcS2 |
list_id Wekan's id for the list (the board column), as returned by wekan.list_lists. | string | Yes | — | — | wJmnfd4bLLYAoRcS2 |
card_id Wekan's id for the card, as returned by wekan.list_cards or wekan.create_card. | string | Yes | — | — | wJmnfd4bLLYAoRcS2 |
title A new title for the card. Wekan truncates it at 1000 characters. | string | No | — | ≤ 1000 characters | Investigate the retry loop |
description A new description for the card, written as Markdown. | string | No | — | — | — |
color The card's colour, as one of the colour names Wekan's card colour picker offers. | string | No | — | — | — |
requested_by Free text naming who asked for the card, shown in the card's details. | string | No | — | — | — |
assigned_by Free text naming who assigned the card, shown in the card's details. | string | No | — | — | — |
received_at The card's received date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
start_at The card's start date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
due_at The card's due date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
end_at The card's end date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
members Ids of the board members to put on the card, separated by commas. Wekan accepts only users who are active members of this board. | string | No | — | — | — |
assignees Ids of the board members to assign the card to, separated by commas. Wekan accepts only users who are active members of this board. | string | No | — | — | — |
label_ids Ids of the board labels to put on the card, separated by commas. This replaces the card's labels rather than adding to them. | string | No | — | — | — |
archive Whether to archive the card (true) or restore it from the archive. | boolean | No | — | — | — |
due_complete Whether the card's due date should be marked as met. | boolean | No | — | — | — |
- At least one of title, description, color, requested_by, assigned_by, received_at, start_at, due_at, end_at, members, assignees, label_ids, archive, due_complete must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"board_id": "wJmnfd4bLLYAoRcS2",
"card_id": "wJmnfd4bLLYAoRcS2",
"list_id": "wJmnfd4bLLYAoRcS2",
"title": "Investigate the retry loop"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
_id The id of the card that was updated. | string | — |
{
"_id": ""
}See Update Card run in a workflow.
In a technical demo we add the Wekan connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.