jokelboard-wrapper

Unofficial API wrappers for Jokelboard, available in JavaScript, TypeScript, and Python.

Packages

Package	Language	Install
packages/typescript	TypeScript (strict, ESM + CJS)	npm install @jokelboard/typescript
packages/js	JavaScript (ESM, no build step)	npm install @jokelboard/js
packages/python	Python 3.10+	pip install jokelboard

Quick start

TypeScript / JavaScript

import { JokelboardClient } from '@jokelboard/typescript';

const client = new JokelboardClient({ token: 'jkb_...' });

const boards = await client.listBoards();
const card = await client.createCard('board-id', 'list-id', 'My card');
await client.addComment('board-id', card.id, 'Hello!');

Python

from jokelboard import JokelboardClient

with JokelboardClient(token="jkb_...") as client:
    boards = client.list_boards()
    card = client.create_card("board-id", "list-id", "My card")
    client.add_comment("board-id", card["id"], "Hello!")

Documentation

• Authentication
• Token compatibility — which token types can reach the Programmatic API vs. the Plugin API
• Error handling
• API reference
• Examples

API coverage

Feature	Supported
Boards (list, get, replace)	✅
Lists (create)	✅
Cards (create, update, patch, move, link, comment)	✅
Vault (list, vault, restore, purge)	✅
Board tokens	✅
Profile tokens	✅
Org tokens + bot config	✅
Plugin API (checklist)	✅ — not available to org tokens, see token compatibility
Auto-retry on rate limit	✅
Revision conflict error	✅

License

MIT