Hanzo Docs
Sign inAPI key

List unowned

Reads, for a SuperAdmin alone, the organization's items that record no owner.

GET /v1/library/unowned

Library → · All API references → · Get started →

Addresshttps://api.hanzo.ai/v1/library/unowned
MethodGET
Operationget_library_unowned
AuthAuthorization: Bearer $HANZO_API_KEY

Reads, for a SuperAdmin alone, the organization's items that record no owner. Such an item is nobody's: no member lists it, reads it or changes it, and this view neither changes it nor signs its bytes. Every read of it is written to the audit trail.

Request

1 field.

FieldInTypeRequiredDescription
limitqueryinteger—Limit bounds the page: default 60, at most 200.

Response

StatusBodyMeaning
200library.itemPageok
defaultproblem-detailsrefused

200 body — 31 fields.

FieldInTypeAlwaysDescription
databodylibrary.LibraryItem[]—Data are the items, newest first.
data[].bybodystring—By is the owner as a reader names them: the name, else the address, the identity boundary carried when the item was made.
data[].bytesbodyinteger (int64)—
data[].createdbodystring—
data[].downloadbodystring—
data[].expiresbodystring—
data[].heightbodyinteger (int64)—
data[].idbodystring—
data[].kindbodystring—
data[].mimebodystring—
data[].minebodyboolean—
data[].namebodystring—
data[].originbodystring—
data[].ownerbodystring—
data[].pagesbodyinteger (int64)—
data[].previewbodystring—
data[].projectbodystring—
data[].refbodystring—
data[].secondsbodynumber (double)—
data[].sharedbodyboolean—
data[].sourcebodystring—
data[].updatedbodystring—
data[].uploadbodylibrary.LibraryUpload—
data[].upload.expiresbodystring—
data[].upload.headersbodylibrary.Field[]—Headers are the ones the PUT must carry.
data[].upload.headers[].namebodystring—Name is the field's name.
data[].upload.headers[].valuebodystring—Value is the field's value, verbatim.
data[].upload.urlbodystring—
data[].urlbodystring—
data[].widthbodyinteger (int64)—
nextbodystring—Next continues the list as cursor; empty at its end.

Failure carries the platform error shape — see Errors.

Examples

hanzo library unowned
import { Configuration, LibraryApi } from 'hanzoai';

const api = new LibraryApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getLibraryUnowned();
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import LibraryApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = LibraryApi(client).get_library_unowned()
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.LibraryAPI.GetLibraryUnowned(context.Background()).Execute()
if err != nil {
	return err
}
use hanzo_client::apis::{configuration::Configuration, library_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = library_api::get_library_unowned(&cfg, Default::default()).await?;
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.LibraryApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new LibraryApi(client).getLibraryUnowned();
curl https://api.hanzo.ai/v1/library/unowned \
  -H "Authorization: Bearer $HANZO_API_KEY"

Tool library, op get_library_unowned — POST the JSON-RPC envelope to https://api.hanzo.ai/v1/mcp.

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "library",
         "arguments": {
           "op": "get_library_unowned",
           "input": {}
         }
       }
     }'

Library API · All Hanzo APIs · Interactive reference

Was this page useful?
Broken link or missing step? Drop it in #docs on Discord or open a PR.
PreviousGet libraryNextList library