Rename a workspace

POST/api/owners/rename

Changes the @handle of a workspace, moving every report, drawer, folder, tag, membership, and subscription reference onto the new handle in one atomic step. Session cookie only — personal access tokens are not accepted; a Bearer-authenticated request returns 403. A personal workspace can only be renamed by its owner; an organization only by one of its admins. The previous handle is released immediately — there is no cooldown, no reservation, and no rate limit — so published links that used it stop resolving at once and the handle becomes available to anyone.

Body Parameters

ownerstringrequired

The workspace to rename, by its current handle.

newSlugstringrequired

The new handle. Same shape rules as POST /api/owners/create.

const res = await fetch("https://leafpage.cc/api/owners/rename", {
  method: "POST",
  headers: {
    "Authorization": "Bearer lp_…",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "owner": "acme",
    "newSlug": "acme-inc"
  }),
});
const data = await res.json();

$ch = curl_init("https://leafpage.cc/api/owners/rename");
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, '{"owner":"acme","newSlug":"acme-inc"}');
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

res = requests.post(
    "https://leafpage.cc/api/owners/rename",
    headers={
        "Authorization": "Bearer lp_…",
        "Content-Type": "application/json",
    },
    json={
      "owner": "acme",
      "newSlug": "acme-inc"
    },
)
data = res.json()

require "net/http"
require "json"

uri = URI("https://leafpage.cc/api/owners/rename")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer lp_…"
req["Content-Type"] = "application/json"
req.body = '{"owner":"acme","newSlug":"acme-inc"}'
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(`{"owner":"acme","newSlug":"acme-inc"}`)
  req, _ := http.NewRequest("POST", "https://leafpage.cc/api/owners/rename", 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/owners/rename")
    .header("Authorization", "Bearer lp_…")
    .header("Content-Type", "application/json")
    .body(r#"{"owner":"acme","newSlug":"acme-inc"}"#)
    .send()
    .await?;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://leafpage.cc/api/owners/rename"))
    .header("Authorization", "Bearer lp_…")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{"owner":"acme","newSlug":"acme-inc"}"""))
    .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/owners/rename");
request.Headers.Add("Authorization", "Bearer lp_…");
request.Content = new StringContent("""{"owner":"acme","newSlug":"acme-inc"}""", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);

curl -X POST "https://leafpage.cc/api/owners/rename" \
  -H "Authorization: Bearer lp_…" \
  -H "Content-Type: application/json" \
  -d '{"owner":"acme","newSlug":"acme-inc"}'

Response200

{
  "ok": true,
  "owner": "acme-inc",
  "previous": "acme"
}