curl --request GET \
--url https://api.ornn.com/v1/orchestrator/drives/{drive_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ornn.com/v1/orchestrator/drives/{drive_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ornn.com/v1/orchestrator/drives/{drive_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ornn.com/v1/orchestrator/drives/{drive_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ornn.com/v1/orchestrator/drives/{drive_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ornn.com/v1/orchestrator/drives/{drive_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ornn.com/v1/orchestrator/drives/{drive_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "77777777-7777-4777-8777-777777777777",
"source_drive_id": null,
"name": "training-data",
"status": "active",
"size_bytes": 1073741824,
"file_count": 42,
"file_tree_status": "ready",
"content_epoch": 7,
"source": {
"status": "ready",
"region": "us-central1",
"read_only": false,
"github_repositories": []
},
"file_capabilities": {
"state": "ready",
"can_upload": true,
"message": null
},
"active_mount": {
"id": "ffffffff-ffff-4fff-8fff-ffffffffffff",
"drive_id": "77777777-7777-4777-8777-777777777777",
"reservation_id": "11111111-1111-4111-8111-111111111111",
"node_id": "33333333-3333-4333-8333-333333333333",
"mount_path": "/home/tenant/volume",
"access": "read-write",
"state": "mounted",
"error": null,
"created_at": "2026-10-14T12:05:00Z",
"updated_at": "2026-10-14T12:07:00Z"
},
"active_mounts": [
{
"id": "ffffffff-ffff-4fff-8fff-ffffffffffff",
"drive_id": "77777777-7777-4777-8777-777777777777",
"reservation_id": "11111111-1111-4111-8111-111111111111",
"node_id": "33333333-3333-4333-8333-333333333333",
"mount_path": "/home/tenant/volume",
"access": "read-write",
"state": "mounted",
"error": null,
"created_at": "2026-10-14T12:05:00Z",
"updated_at": "2026-10-14T12:07:00Z"
}
],
"created_at": "2026-10-01T12:00:00Z",
"updated_at": "2026-10-14T12:07:00Z"
}{
"code": "<string>",
"detail": "<string>"
}{
"code": "<string>",
"detail": "<string>"
}{
"detail": {
"code": "storage_drive_not_found",
"message": "Ornn could not find that volume."
}
}{
"code": "<string>",
"detail": "<string>"
}Get a volume
Returns one of your volumes with its size, recent files, repository pulls, and active mounts. Set refresh=true to re-measure the volume’s size from its stored files before returning it.
curl --request GET \
--url https://api.ornn.com/v1/orchestrator/drives/{drive_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ornn.com/v1/orchestrator/drives/{drive_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ornn.com/v1/orchestrator/drives/{drive_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ornn.com/v1/orchestrator/drives/{drive_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ornn.com/v1/orchestrator/drives/{drive_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ornn.com/v1/orchestrator/drives/{drive_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ornn.com/v1/orchestrator/drives/{drive_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "77777777-7777-4777-8777-777777777777",
"source_drive_id": null,
"name": "training-data",
"status": "active",
"size_bytes": 1073741824,
"file_count": 42,
"file_tree_status": "ready",
"content_epoch": 7,
"source": {
"status": "ready",
"region": "us-central1",
"read_only": false,
"github_repositories": []
},
"file_capabilities": {
"state": "ready",
"can_upload": true,
"message": null
},
"active_mount": {
"id": "ffffffff-ffff-4fff-8fff-ffffffffffff",
"drive_id": "77777777-7777-4777-8777-777777777777",
"reservation_id": "11111111-1111-4111-8111-111111111111",
"node_id": "33333333-3333-4333-8333-333333333333",
"mount_path": "/home/tenant/volume",
"access": "read-write",
"state": "mounted",
"error": null,
"created_at": "2026-10-14T12:05:00Z",
"updated_at": "2026-10-14T12:07:00Z"
},
"active_mounts": [
{
"id": "ffffffff-ffff-4fff-8fff-ffffffffffff",
"drive_id": "77777777-7777-4777-8777-777777777777",
"reservation_id": "11111111-1111-4111-8111-111111111111",
"node_id": "33333333-3333-4333-8333-333333333333",
"mount_path": "/home/tenant/volume",
"access": "read-write",
"state": "mounted",
"error": null,
"created_at": "2026-10-14T12:05:00Z",
"updated_at": "2026-10-14T12:07:00Z"
}
],
"created_at": "2026-10-01T12:00:00Z",
"updated_at": "2026-10-14T12:07:00Z"
}{
"code": "<string>",
"detail": "<string>"
}{
"code": "<string>",
"detail": "<string>"
}{
"detail": {
"code": "storage_drive_not_found",
"message": "Ornn could not find that volume."
}
}{
"code": "<string>",
"detail": "<string>"
}ornn volumes show <volume> reads the volume, and ornn volumes refresh <volume> re-measures its size.Authorizations
Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.
Path Parameters
Volume ID.
Query Parameters
Re-measure size_bytes from the stored files. Slower than a plain read.
Response
The volume.
A volume. Responses can include additional fields; ignore fields you do not recognize.
active for a usable volume.
The volume this one was duplicated from.
Measured size. It can lag writes from mounted machines.
A preview of recently updated files. Use List volume files for a complete listing.
Increases whenever the volume's files change.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The volume's mount on one VM or Bare Metal node.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?