The Madless API gives you programmatic access to your entire knowledge space — concepts, relations, files, timeline, and more. Build integrations that capture knowledge from any source, automate connections between ideas, and query your personal intelligence layer.
A space admin mints a key in Settings → Developer. You will need a paid plan with the api-keys entitlement and the admin.write scope. See Authentication for the full requirements.
Create concepts, manage relations, run semantic search across your knowledge graph.
Share concepts, discover emergent edges, and think together as a team.
Tie concepts to events, scrub history, and surface returning ideas alongside your day.
Upload files via signed URLs, organize drives, preview documents, and manage storage.
Subscribe to events across modules. Receive real-time payloads for any resource change.
All endpoints live under your space-specific base URL. Replace {space} with your space slug.
https://{space}.madless.com/api/v1/Open Settings → Developer → API Keys in your space and generate a new key. Choose the scopes your integration needs.
Copy the key (it starts with mad_sk_) and your space slug. You will need both for every request.
Use the example below to list concepts in your Canvas. Replace the space slug and API key with your own.
curl 'https://acme.madless.com/api/v1/canvas' \
-H 'Authorization: Bearer mad_sk_abc123...' \
-H 'Content-Type: application/json'Every successful response wraps the result in a data envelope. Paginated endpoints include a next_cursor for cursor-based pagination.
{
"data": [
{
"id": "cpt_abc123",
"title": "Compound Intelligence",
"state": "present",
"created_at": "2026-03-15T09:00:00Z"
}
],
"next_cursor": "eyJsYXN0SWQiOiAiY3B0X2FiYzEyMyJ9"
}