Get the workspace taxonomy

GET/api/taxonomy

Returns the whole sidebar in one call: the cabinet (drawers, each with its folders nested inside), root-level folders (those not filed under any drawer), the flat tag list, smart-view counts, and the workspace default upload folder. Requires reports:read. Every count is scoped to the caller: items owned by other accounts under the same owner slug are never counted, and tag counts include descendants with each item counted once. tags is a flat array — each entry carries parent_id and a materialized path (/<ancestor id>/…/<own id>/) so a client can build the tree itself. When a workspace holds more than 500 tags the response carries only the root-level tags and sets lazy to true; the counts on those roots still include their descendants. The response is revalidatable: it carries an ETag (also mirrored in the etag field) that is specific to both the workspace and the caller. Sending it back as If-None-Match yields 304 Not Modified with an empty body.

Query Parameters

ownerstringrequired

Workspace owner slug.

const res = await fetch("https://leafpage.cc/api/taxonomy?owner=…", {
  method: "GET",
  headers: {
    "Authorization": "Bearer lp_…",
  },
});
const data = await res.json();

$ch = curl_init("https://leafpage.cc/api/taxonomy?owner=…");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer lp_…"]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

res = requests.get(
    "https://leafpage.cc/api/taxonomy?owner=…",
    headers={
        "Authorization": "Bearer lp_…",
    },
)
data = res.json()

require "net/http"
require "json"

uri = URI("https://leafpage.cc/api/taxonomy?owner=…")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer lp_…"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
data = JSON.parse(res.body)

package main

import (
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://leafpage.cc/api/taxonomy?owner=…", nil)
  req.Header.Set("Authorization", "Bearer lp_…")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
}

let client = reqwest::Client::new();
let res = client.get("https://leafpage.cc/api/taxonomy?owner=…")
    .header("Authorization", "Bearer lp_…")
    .send()
    .await?;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://leafpage.cc/api/taxonomy?owner=…"))
    .header("Authorization", "Bearer lp_…")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://leafpage.cc/api/taxonomy?owner=…");
request.Headers.Add("Authorization", "Bearer lp_…");
var response = await client.SendAsync(request);

curl "https://leafpage.cc/api/taxonomy?owner=…" \
  -H "Authorization: Bearer lp_…"

Response200

{
  "drawers": [
    {
      "id": "d1a2b3c4d5e6f7g8",
      "title": "R&D",
      "count": 18,
      "folders": [
        {
          "id": "f1a2b3c4d5e6f7g8",
          "title": "Weekly",
          "count": 12
        },
        {
          "id": "f2a2b3c4d5e6f7g8",
          "title": "Decisions",
          "count": 6
        }
      ]
    }
  ],
  "rootFolders": [
    {
      "id": "f3a2b3c4d5e6f7g8",
      "title": "Drafts",
      "count": 3
    }
  ],
  "tags": [
    {
      "id": "t1a2b3c4d5e6f7g8",
      "parent_id": null,
      "title": "Customer",
      "path": "/t1a2b3c4d5e6f7g8/",
      "depth": 1,
      "count": 24
    },
    {
      "id": "t2a2b3c4d5e6f7g8",
      "parent_id": "t1a2b3c4d5e6f7g8",
      "title": "Acme Inc",
      "path": "/t1a2b3c4d5e6f7g8/t2a2b3c4d5e6f7g8/",
      "depth": 2,
      "count": 11
    }
  ],
  "smart": {
    "all": 128,
    "recent": 128,
    "unfiled": 12
  },
  "defaultFolderId": "f1a2b3c4d5e6f7g8",
  "etag": "\"a1b2c3d4e5f6a7b8\"",
  "lazy": false
}