Authentication

Authentication

Jokelboard uses Bearer token authentication. All tokens begin with jkb_.

---

Token types

Kind	Scope	Use case
Board token	Single board	Bot integrations, per-project automation
Profile token	All boards you own	Personal scripts, CLI tools
Org token	All boards in an organisation	Org-wide automation, admin tasks

Generate tokens from your Jokelboard account settings.

---

Setting the token

JavaScript

import { JokelboardClient } from '@yeetgodpro1324/jokelboard-js';

const client = new JokelboardClient({
  token: process.env.JOKELBOARD_TOKEN,
});

TypeScript

import { JokelboardClient } from '@yeetgodpro1324/jokelboard-ts';

const client = new JokelboardClient({
  token: process.env.JOKELBOARD_TOKEN,
});

Python

import os
from jokelboard import JokelboardClient

client = JokelboardClient(token=os.environ["JOKELBOARD_TOKEN"])

# or as a context manager (auto-closes the HTTP session)
with JokelboardClient(token=os.environ["JOKELBOARD_TOKEN"]) as client:
    ...

---

Security best practices

• Store tokens in environment variables — never hard-code them.
• Use the narrowest token scope that satisfies your use case (board > profile > org).
• Rotate tokens if they are exposed.