The Madless API gives you programmatic access to your entire knowledge space — concepts, relations, files, calendar, and more. Build integrations that capture knowledge from any source, automate connections between ideas, and query your personal intelligence layer.
Create concepts, manage relations, run semantic search across your knowledge graph.
Release concepts, discover emergent edges, and build collective intelligence with your circle.
Schedule events, manage availability, and link review rhythms to your concepts.
Upload files via signed URLs, organize drives, preview documents, and manage storage.
Share concepts externally via magic links. Recipients contribute without an account.
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/concepts' \
-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"
}