nextcloud-deck-client

A Python client for the Nextcloud Deck API, with both synchronous and asynchronous clients.

Install

pip install nextcloud-deck-client

Use

from ncdeck import DeckClient

deck = DeckClient("https://cloud.example.com", "username", "app-password", board_id=1)

for stack in deck.get_stacks():
    print(stack.title)
    for card in stack.cards:
        print("   ", card.title)

Async:

from ncdeck import AsyncDeckClient

deck = AsyncDeckClient("https://cloud.example.com", "username", "app-password")
boards = await deck.get_boards()

What it covers

Boards, stacks, cards, labels, comments and attachments. Cards can be created, updated, moved, archived, deleted and patched. The activity feed is exposed so callers can determine when a card was moved. DeckClient (sync) and AsyncDeckClient (async) expose the same methods with the same arguments — pick whichever matches your program and the two are interchangeable.

Two Deck quirks are handled for you:

  • move_card() uses the documented update route addressed at the target stack, rather than the /cards/{id}/reorder endpoint, working around Deck issue #6830. The /reorder route makes Deck renumber every card in the target stack and stamp lastModified on all of them; move_card() avoids that, so lastModified stays a reliable signal for every other card in the stack.
  • The activity endpoint answers HTTP 304 with an empty body when there is no data; get_deck_activity() returns an empty list rather than failing.

Changing a card without blanking it

Deck's card update endpoint treats every omitted field as a default, so a partial payload silently clears description and duedate. patch_card resends the card's full state with your changes applied:

card = next(c for c in stacks[0].cards if c.title == "Timeliste")
client.patch_card(card, done="2026-08-04T12:00:00+00:00")  # tick it
client.patch_card(card, done=None)  # un-tick it

move_card(card, stack_id, clear_done=True) moves a card and drops its done-tick in one request.

1.0.0 — breaking changes

  • board_id moved to the last, optional parameter on every method of both DeckClient and AsyncDeckClient.
  • move_card() now takes a Card instead of raw stack/card ids, and requires .source to be populated (fetch the card via get_stacks() first) — it raises ValueError otherwise. It no longer renumbers sibling cards, so several cards in the target stack may end up sharing order: 0.
  • fetch_stacks() was removed in favour of get_stacks().

Authentication

Use a Nextcloud app password, not your account password.

Related tools

nextcloud-deck-cli is a set of command-line tools for Nextcloud Deck built on top of this library.

Licence

LGPL-3.0-or-later. See COPYING.LESSER.

Project links

Data verified by PyPI on Aug 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for olen from gravatar.com olen

Credits

Author: Ola Thoresen

GitHub Statistics

Data verified by PyPI on Aug 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU Lesser General Public License v3 or later (LGPLv3+) (LGPL-3.0-or-later)

Requires

Python >=3.11

Tags

nextcloud deck kanban api client

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nextcloud_deck_client-1.1.0.tar.gz (23.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nextcloud_deck_client-1.1.0-py3-none-any.whl (28.7 kB view details)

Uploaded Python 3

File details

Details for the file nextcloud_deck_client-1.1.0.tar.gz.

File metadata

  • Download URL: nextcloud_deck_client-1.1.0.tar.gz
  • Upload date:
  • Size: 23.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nextcloud_deck_client-1.1.0.tar.gz
Algorithm Hash digest
SHA256 7796c56ed5071e9df1fd3540fdc5a73151b8f125f35c2973286ed4fe41f0c2e4
MD5 77c5d70f23cda21eb9b2875ebe24b563
BLAKE2b-256 18d4093512aeae710f236f3a6afc890636929e9010bde7ce6a1e3fcff25492cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for nextcloud_deck_client-1.1.0.tar.gz:

Publisher: release.yml on Olen/nextcloud-deck-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nextcloud_deck_client-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for nextcloud_deck_client-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ef53160cf4ab40dd1dc981d007b895169241aab04fbd6e9f7cfaa351f332ced3
MD5 f995155dd6223bf9dcf5d94ba2ac3432
BLAKE2b-256 7e2a38fbdf622476c6ff2100f052e2c0972f8d44b83af4f376cbc9ea7d7894de

See more details on using hashes here.

Provenance

The following attestation bundles were made for nextcloud_deck_client-1.1.0-py3-none-any.whl:

Publisher: release.yml on Olen/nextcloud-deck-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page