Developer API
Build custom integrations, automate workspace creation, and programmatically export your infinite canvases using the Kidraw REST API.
RESTful Design
Predictable, resource-oriented URLs. Accepts form-encoded request bodies, returns JSON-encoded responses.
API Keys
Generate personal access tokens from your dashboard settings to authenticate requests securely.
Authentication
Authenticate your API requests by including your secret API key in the Authorization HTTP header. Never share your secret keys in publicly accessible areas such as GitHub or client-side code.
Example Request
curl https://api.kidraw.com/v1/boards \
-H "Authorization: Bearer kd_live_xxx..."
-H "Authorization: Bearer kd_live_xxx..."
Create a Board
POSTCreates a new empty board workspace and returns its unique identifier. You can optionally pass an initial title.
Parameters
titlestring, optional
The name of the new board. Defaults to 'Untitled'.
is_privateboolean, optional
Whether the board is restricted to invited members only.
Response
{
"id": "brd_8x29d10s",
"title": "Q4 Roadmap",
"created_at": "2024-10-24T12:00:00Z",
"url": "https://kidraw.com/b/brd_8x29d10s"
}
"id": "brd_8x29d10s",
"title": "Q4 Roadmap",
"created_at": "2024-10-24T12:00:00Z",
"url": "https://kidraw.com/b/brd_8x29d10s"
}