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 and deleted. 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.

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:
Newer release available (1.1.0)

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.0.0.tar.gz (22.0 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.0.0-py3-none-any.whl (26.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nextcloud_deck_client-1.0.0.tar.gz
  • Upload date:
  • Size: 22.0 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.0.0.tar.gz
Algorithm Hash digest
SHA256 7f2a70e652933ce3dd0457f5a3d4127fe24759f73164c18c672fa5b2d1bb4905
MD5 d0d0f33ea98f26a634533228be352f74
BLAKE2b-256 31e7005d27571a216c1fdd0eb7d2d10901440554e78ca15aca02ed0a872e637b

See more details on using hashes here.

Provenance

The following attestation bundles were made for nextcloud_deck_client-1.0.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.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for nextcloud_deck_client-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b8d1881693183fba35a98de906797ac4ad19df77d4b6818649bc14d99899b0b6
MD5 2c3d88a0d748cb96ef989cee0a7c462b
BLAKE2b-256 fffcdd82b6303e036e2a346f71952ed2ecda81fd8ccd0fb26c27ec1667566214

See more details on using hashes here.

Provenance

The following attestation bundles were made for nextcloud_deck_client-1.0.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