Tensorlake Documentation

Detach a filesystem

curl --request DELETE \
  --url https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mount_path": "<string>"
}
'

import requests

url = "https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems"

payload = { "mount_path": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({mount_path: '<string>'})
};

fetch('https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems', 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.tensorlake.ai/sandboxes/{sandbox_id}/file_systems",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'mount_path' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems"

	payload := strings.NewReader("{\n  \"mount_path\": \"<string>\"\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"mount_path\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"mount_path\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "namespace": "<string>",
  "status": "pending",
  "created_at": 123,
  "resources": {
    "cpus": 123,
    "memory_mb": 123,
    "disk_mb": 123
  },
  "timeout_secs": 123,
  "allow_unauthenticated_access": true,
  "image": "<string>",
  "pending_reason": "<string>",
  "outcome": "<string>",
  "termination_reason": "<string>",
  "error_details": "<string>",
  "container_id": "<string>",
  "executor_id": "<string>",
  "ingress_endpoint": "<string>",
  "sandbox_url": "<string>",
  "pool_id": "<string>",
  "network_policy": {
    "allow_internet_access": true,
    "allow_out": [
      "<string>"
    ],
    "deny_out": [
      "<string>"
    ]
  },
  "exposed_ports": [
    32768
  ],
  "template_id": "<string>",
  "name": "<string>",
  "file_systems": [
    {
      "file_system_id": "<string>",
      "mount_path": "<string>",
      "read_only": false,
      "prefetch": false,
      "snapshot_id": "<string>"
    }
  ]
}

DELETE

sandboxes

{sandbox_id}

file_systems

Detach a filesystem

curl --request DELETE \
  --url https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mount_path": "<string>"
}
'

import requests

url = "https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems"

payload = { "mount_path": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({mount_path: '<string>'})
};

fetch('https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems', 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.tensorlake.ai/sandboxes/{sandbox_id}/file_systems",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'mount_path' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems"

	payload := strings.NewReader("{\n  \"mount_path\": \"<string>\"\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"mount_path\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tensorlake.ai/sandboxes/{sandbox_id}/file_systems")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"mount_path\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "namespace": "<string>",
  "status": "pending",
  "created_at": 123,
  "resources": {
    "cpus": 123,
    "memory_mb": 123,
    "disk_mb": 123
  },
  "timeout_secs": 123,
  "allow_unauthenticated_access": true,
  "image": "<string>",
  "pending_reason": "<string>",
  "outcome": "<string>",
  "termination_reason": "<string>",
  "error_details": "<string>",
  "container_id": "<string>",
  "executor_id": "<string>",
  "ingress_endpoint": "<string>",
  "sandbox_url": "<string>",
  "pool_id": "<string>",
  "network_policy": {
    "allow_internet_access": true,
    "allow_out": [
      "<string>"
    ],
    "deny_out": [
      "<string>"
    ]
  },
  "exposed_ports": [
    32768
  ],
  "template_id": "<string>",
  "name": "<string>",
  "file_systems": [
    {
      "file_system_id": "<string>",
      "mount_path": "<string>",
      "read_only": false,
      "prefetch": false,
      "snapshot_id": "<string>"
    }
  ]
}

Detach the filesystem mounted at a guest path from a running sandbox.

This path accepts either the sandbox ID or the sandbox name.
200 OK means the removal is persisted; the unmount applies asynchronously on the live sandbox moments later.
Tensorlake returns 404 Not Found when no filesystem is mounted at the given path.
Tensorlake returns 409 Conflict when the sandbox is not running.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

sandbox_id

string

required

The sandbox ID or sandbox name.

Body

application/json

mount_path

string

required

Absolute guest mount path of the filesystem to detach.

Response

Filesystem detach accepted and persisted; the returned sandbox no longer lists the file_systems entry

string

required

namespace

string

required

status

enum<string>

required

Available options:

pending,

running,

snapshotting,

suspending,

suspended,

terminated

created_at

integer<int64>

required

Milliseconds since Unix epoch.

resources

object

required

Show child attributes

timeout_secs

integer<int64>

required

allow_unauthenticated_access

boolean

required

Whether sandbox ingress may route requests without auth validation.

image

string

pending_reason

string | null

Present when status is pending.

outcome

string | null

Platform-specific termination outcome string returned for completed sandboxes.

termination_reason

string | null

Typed reason the sandbox terminated (e.g. FileSystemNotFound, FileSystemSnapshotNotFound, ImageNotFound). Present on failed terminations.

error_details

string | null

Human-readable detail accompanying termination_reason.

container_id

string | null

executor_id

string | null

ingress_endpoint

string | null

Canonical server-provided base for sandbox-specific ingress.

sandbox_url

string | null

Sandbox-specific management URL derived from ingress_endpoint.

pool_id

string | null

network_policy

null | object

Show child attributes

exposed_ports

integer<int32>[] | null

Additional routable ingress ports. When null, only the management port 9501 is routable.

Required range: 1 <= x <= 65535

template_id

string | null

name

string | null

file_systems

object[]

Filesystems currently mounted into the sandbox.

Show child attributes

API Documentation

Sandboxes

Detach Filesystem

Authorizations

Path Parameters

Body

Response