Book a demo

List Cards

wekan.list_cards
ActionBusiness appsconnection required

Calls the Wekan API with the connection's credentials.

List the unarchived cards in one list of a board.

Ask about WekanAll Wekan nodesProvider API docs ↗

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

2 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
board_id
Wekan's id for the board. It is the long identifier in the board URL, not its title.
stringYes——wJmnfd4bLLYAoRcS2
list_id
Wekan's id for the list (the board column), as returned by wekan.list_lists.
stringYes——wJmnfd4bLLYAoRcS2

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "board_id": "wJmnfd4bLLYAoRcS2",
  "list_id": "wJmnfd4bLLYAoRcS2"
}

Output

One shape.

result

FieldTypeExample
items
The list's unarchived cards, in board order.
array—
items[]._id
Wekan's id for the card.
string—
items[].title
The card's title.
string—
items[].description
The card's description.
string—
items[].swimlaneId
Id of the swimlane the card sits in.
string—
items[].receivedAt
The received date, as an ISO-8601 timestamp.
string—
items[].startAt
The start date, as an ISO-8601 timestamp.
string—
items[].dueAt
The due date, as an ISO-8601 timestamp.
string—
items[].endAt
The end date, as an ISO-8601 timestamp.
string—
items[].assignees
Ids of the users assigned to the card.
array—
items[].sort
The card's sort position within its list.
number—
count
How many cards were returned.
number—
{
  "count": 0,
  "items": [
    {
      "_id": "",
      "assignees": [],
      "description": "",
      "dueAt": "",
      "endAt": "",
      "receivedAt": "",
      "sort": 0,
      "startAt": "",
      "swimlaneId": "",
      "title": ""
    }
  ]
}

Related Wekan nodes

See List Cards 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.

Book a technical demoTalk to sales