Bulk file or unfile items

POST/api/items/set-folder

Files (or unfiles, with folder_id: null) a batch of Leaves and/or standalone reports into a folder. Filing lives at the Leaf level (not the version level), so re-uploading a new version never resets it. Up to 200 items per request. All-or-nothing: any item that does not exist, is owned by another account, or a folder_id from a different workspace fails the whole batch with no partial writes. Requires reports:write. Prefer this over the deprecated POST /api/set-folder, which takes a single legacy path string instead of a batch of typed item references.

Body Parameters

itemsarray of objectsrequired

Show child attributes

namestring

Leaf (group) name.

codestring

Standalone report code.

folder_idstringrequired

Destination folder id, or null to unfile. The key is required even when unfiling: omitting it is a 400, so a misspelled field name cannot silently unfile the whole batch.

const res = await fetch("https://leafpage.cc/api/items/set-folder", {
  method: "POST",
  headers: {
    "Authorization": "Bearer lp_…",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "items": [
      {
        "name": "quarterly-report"
      }
    ],
    "folder_id": "f1a2b3c4d5e6f7g8"
  }),
});
const data = await res.json();

$ch = curl_init("https://leafpage.cc/api/items/set-folder");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer lp_…", "Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"items":[{"name":"quarterly-report"}],"folder_id":"f1a2b3c4d5e6f7g8"}');
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

res = requests.post(
    "https://leafpage.cc/api/items/set-folder",
    headers={
        "Authorization": "Bearer lp_…",
        "Content-Type": "application/json",
    },
    json={
      "items": [
        {
          "name": "quarterly-report"
        }
      ],
      "folder_id": "f1a2b3c4d5e6f7g8"
    },
)
data = res.json()

require "net/http"
require "json"

uri = URI("https://leafpage.cc/api/items/set-folder")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer lp_…"
req["Content-Type"] = "application/json"
req.body = '{"items":[{"name":"quarterly-report"}],"folder_id":"f1a2b3c4d5e6f7g8"}'
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"
  "strings"
)

func main() {
  body := strings.NewReader(`{"items":[{"name":"quarterly-report"}],"folder_id":"f1a2b3c4d5e6f7g8"}`)
  req, _ := http.NewRequest("POST", "https://leafpage.cc/api/items/set-folder", body)
  req.Header.Set("Authorization", "Bearer lp_…")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
}

let client = reqwest::Client::new();
let res = client.post("https://leafpage.cc/api/items/set-folder")
    .header("Authorization", "Bearer lp_…")
    .header("Content-Type", "application/json")
    .body(r#"{"items":[{"name":"quarterly-report"}],"folder_id":"f1a2b3c4d5e6f7g8"}"#)
    .send()
    .await?;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://leafpage.cc/api/items/set-folder"))
    .header("Authorization", "Bearer lp_…")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{"items":[{"name":"quarterly-report"}],"folder_id":"f1a2b3c4d5e6f7g8"}"""))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://leafpage.cc/api/items/set-folder");
request.Headers.Add("Authorization", "Bearer lp_…");
request.Content = new StringContent("""{"items":[{"name":"quarterly-report"}],"folder_id":"f1a2b3c4d5e6f7g8"}""", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);

curl -X POST "https://leafpage.cc/api/items/set-folder" \
  -H "Authorization: Bearer lp_…" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"name":"quarterly-report"}],"folder_id":"f1a2b3c4d5e6f7g8"}'

Response200

{
  "ok": true,
  "folder_id": "f1a2b3c4d5e6f7g8"
}