Hanzo AI
OpenapiSpace

List drives

Lists a space's drives. Listing the drives IS listing the space's root folder, because a drive is the first segment of a key and nothing else — so the two…

GET /v1/space/{space}/drives

Addresshttps://api.hanzo.ai/v1/space/{space}/drives
MethodGET
Operationget_space_by_space_drives
AuthAuthorization: Bearer $HANZO_API_KEY

Lists a space's drives.

Listing the drives IS listing the space's root folder, because a drive is the first segment of a key and nothing else — so the two can never disagree the way a drives table and the keys under it would. A space the caller's org does not own is the same 404 an unknown name gives.

Billed per call: the balance is checked BEFORE anything is touched, so an unfunded org is refused with nothing read, and the debit lands only once the listing has succeeded.

Request

1 field.

FieldInTypeRequiredDescription
spacepathstringyesSpace is the space's name, from the path.

Response

StatusBodyMeaning
200space.driveListok
defaultproblem-detailsrefused

200 body — 4 fields.

FieldInTypeAlwaysDescription
drivesbodyspace.driveItem[]Drives are the drives at the space's root.
drives[].namebodystringName is the drive's name — the first segment of every key it holds.
spacebodystringSpace is the space that was listed.
totalbodyinteger (int64)Total is how many drives came back.

Failure carries the platform error shape — see Errors.

Examples

hanzo space drives list <space>

Space API · All Hanzo APIs · Interactive reference

How is this guide?

On this page