At TensorDock, we're building a compute marketplace where customers deploy VMs on the servers of our global network of hosts.
\nWe've built an HTTP REST API that you can use to deploy new servers, start/stop them, and delete them. With our API, you can automatically scale from 0 to 1000+ GPUs in minutes atop the world's most cost-effective GPU infrastructure.
\nContact support@tensordock.com if you need any help or if you want a specific API endpoint to be built :)
\nWe do not rate limit, but please keep API requests reasonable (e.g. 1 request per second) to ensure that we don't need to rate limit. We want the API to be fast for everyone. We can build bulk action APIs as needed too — just let us know :)
\nAuthentication is done organization-wide. API keys and tokens are tied to an organization and not a specific user. Thus, deleting a user from an organization will not remove any API keys.
\nYou can also create an unlimited number of authorization pairs for maximum granularity. We recommend one authorization for each external integration you make for best security.
\nYou can get access to your API token and info here: https://dashboard.tensordock.com/api
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Rate limit","slug":"rate-limit"},{"content":"Create an API key/token","slug":"create-an-api-keytoken"}],"owner":"20973002","collectionId":"5afcabf4-e7a9-499a-9295-c187201b73ad","publishedId":"2s8YzMYRDc","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"161c2d","highlight":"2fa858"},"publishDate":"2022-12-10T22:09:12.000Z"},"item":[{"name":"Getting Started","item":[{"name":"Test Authorization","event":[{"listen":"test","script":{"id":"45390793-0124-48b8-b3ba-3a2ee3129471","exec":[""],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"packages":{},"type":"text/javascript"}}],"id":"ee467ada-3591-486c-9635-f7c209b2d8b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"6addbaf1-778f-4484-98c8-4f1af9efa527","type":"text"},{"key":"api_token","value":"6AVxZ4sGIDmi5N3dcFL1vebM5Tmga8Xf","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/auth/test","description":"First, let's confirm that your authorization is working. If you're having trouble using another one of our APIs, we'll usually direct you here to confirm that you're correctly passing in fields into our API.
\nHere you can test that an authorization is registered and working.
\nSimply pass in your API key as api_key and API token as api_token, and confirm that we return true!
We will return an object {\"success\": true} if your authorization key and token are valid.
This gets a list of all others authorizations.
\n","urlObject":{"protocol":"https","path":["api","v0","auth","list"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"431c8218-62be-4a2b-9695-9cfbd12ece2c","name":"Default","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"url":{"raw":"https://dashboard.tensordock.com/api/v0/auth/list?api_key=API_KEY_HERE&api_token=API_TOKEN_HERE","protocol":"https","host":["dashboard","tensordock","com"],"path":["api","v0","auth","list"],"query":[{"key":"api_key","value":"API_KEY_HERE"},{"key":"api_token","value":"API_TOKEN_HERE"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"success\": true,\r\n \"authorizations\": {\r\n \"test_auth\": {\r\n \"permissions\": \"All\",\r\n \"timestamp_creation\": \"2022-12-04 02:26:01.898472\",\r\n \"note\": \"Use for testing purposes\"\r\n }, \r\n \"perm_auth\": {\r\n \"permissions\": \"All\",\r\n \"timestamp_creation\": \"2022-12-03 03:43:07.125862\",\r\n \"note\": \"Permanant use cases\"\r\n }\r\n }\r\n}"}],"_postman_id":"fe67a68e-fca7-4a58-bead-b4d217671fae"}],"id":"c7886c17-8de0-45a7-b876-fdaa285408d2","_postman_id":"c7886c17-8de0-45a7-b876-fdaa285408d2","description":""},{"name":"Available Servers","item":[{"name":"Available Hostnodes","id":"2b4a3db0-c162-438c-aae4-6a88afc96fdb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"https://dashboard.tensordock.com/api/v0/client/deploy/hostnodes?minRAM=20&minStorage=20&minVRAM=4&minGPUCount=1&requiresRTX=false&requiresGTX=false&maxGPUCount=8","description":"This gets a list of all available hostnodes and stock for GPUs. You will need to keep track of the GPU model and available CPU/RAM for the deployment step. All params are optional, but can be added to filter for certain hostnodes.
\nNote: If you include your organization's API key and token in the request, like such:
\nhttps://marketplace.tensordock.com/api/v0/client/deploy/hostnodes?api_key=KEY&api_token=TOKEN
\nHostnodes that are reserved for your organization will also show up in the list.
\n","urlObject":{"protocol":"https","path":["api","v0","client","deploy","hostnodes"],"host":["dashboard","tensordock","com"],"query":[{"disabled":true,"description":{"content":"Minimum number of vCPUs
\n","type":"text/plain"},"key":"minvCPUs","value":"1"},{"description":{"content":"Minimum amount of RAM
\n","type":"text/plain"},"key":"minRAM","value":"20"},{"description":{"content":"Minimum SSD storage amount in GB
\n","type":"text/plain"},"key":"minStorage","value":"20"},{"description":{"content":"Minimum VRAM amount
\n","type":"text/plain"},"key":"minVRAM","value":"4"},{"description":{"content":"Minimum number of GPUs
\n","type":"text/plain"},"key":"minGPUCount","value":"1"},{"description":{"content":"Requires RTX GPU
\n","type":"text/plain"},"key":"requiresRTX","value":"false"},{"description":{"content":"Requires GTX GPU
\n","type":"text/plain"},"key":"requiresGTX","value":"false"},{"description":{"content":"Maximum number of GPUs (Set to 0 to find available hostnodes for CPU-only deployments)
\n","type":"text/plain"},"key":"maxGPUCount","value":"8"}],"variable":[]}},"response":[{"id":"8502e5d8-ca28-4dc1-bf6b-af81b4f119f3","name":"Default","originalRequest":{"method":"GET","header":[],"url":"https://dashboard.tensordock.com/api/v0/client/deploy/hostnodes"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"hostnodes\": {\n \"02c65d45-6da5-4232-a8db-ee0e5bc76110\": {\n \"location\": {\n \"city\": \"Winnipeg\",\n \"country\": \"Canada\",\n \"dc\": null,\n \"id\": \"50cf200c-be1b-4983-a316-369d2eea10ec\",\n \"region\": \"Manitoba\"\n },\n \"networking\": {\n \"ports\": [\n 20013,\n 20012,\n 20011,\n 20010,\n 20009,\n 20008,\n 20007,\n 20006,\n 20005,\n 20004,\n 20003,\n 20002,\n 20001,\n 8935,\n 8080,\n 8000,\n 3389,\n 3000,\n 443,\n 80\n ],\n \"receive\": 1000,\n \"send\": 1000\n },\n \"specs\": {\n \"cpu\": {\n \"amount\": 26,\n \"price\": 0.003,\n \"type\": \"AMD Ryzen 9 5950X\"\n },\n \"gpu\": {\n \"geforcertx3080-pcie-10gb\": {\n \"amount\": 1,\n \"price\": 0.15\n }\n },\n \"ram\": {\n \"amount\": 100,\n \"price\": 0.002\n },\n \"storage\": {\n \"amount\": 580,\n \"price\": 0.00005\n }\n },\n \"status\": {\n \"listed\": true,\n \"online\": true,\n \"report\": \"https://monitor.m.tensordock.com/report/uptime/12c94b1b3c8471877d59005b08eb693e/\",\n \"uptime\": 0.9999\n }\n },\n \"e817be06-f7b7-4a14-8bb8-fe04569b25f8\": {\n \"location\": {\n \"city\": \"Winnipeg\",\n \"country\": \"Canada\",\n \"dc\": null,\n \"id\": \"50cf200c-be1b-4983-a316-369d2eea10ec\",\n \"region\": \"Manitoba\"\n },\n \"networking\": {\n \"ports\": [\n 30019,\n 30018,\n 30017,\n 30013,\n 30012,\n 30011,\n 30010,\n 30009,\n 30008,\n 30007,\n 30006,\n 30005,\n 30004,\n 30003,\n 30002,\n 30001\n ],\n \"receive\": 1000,\n \"send\": 1000\n },\n \"specs\": {\n \"cpu\": {\n \"amount\": 12,\n \"price\": 0.003,\n \"type\": \"AMD Ryzen 7 5800X\"\n },\n \"gpu\": {\n \"geforcertx4090-pcie-24gb\": {\n \"amount\": 1,\n \"price\": 0.4\n }\n },\n \"ram\": {\n \"amount\": 41,\n \"price\": 0.002\n },\n \"storage\": {\n \"amount\": 500,\n \"price\": 0.00005\n }\n },\n \"status\": {\n \"listed\": true,\n \"online\": true,\n \"report\": \"https://monitor.m.tensordock.com/report/uptime/99894b4dd500bf0af5a906eb8f85e1c3/\",\n \"uptime\": 0.9998\n }\n }\n },\n \"success\": true\n}"}],"_postman_id":"2b4a3db0-c162-438c-aae4-6a88afc96fdb"},{"name":"Specific Hostnode Details","id":"a12a8130-6416-4fae-a8bf-929daa994950","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"https://dashboard.tensordock.com/api/v0/client/deploy/hostnodes/Instead of returning all available hostnodes, you can also return the information of a specific one based on its UUID.
\n","urlObject":{"protocol":"https","path":["api","v0","client","deploy","hostnodes","Password for the VM. Optional if you have set an SSH key. The username for the VM will always be \"user\".
\n","type":"text"},{"key":"ssh_key","value":"ssh-rsa AAAXB3NzaC1yc2EAAAADAQABAAABAQDFtMHOaiM9LlNlG6lrtrF+....","description":"Either set this field, set a password, or have an SSH key stored with your organization [to override this field]
\n","type":"text"},{"key":"name","value":"My RTX 4000 Server","description":"Name of your VM to be displayed in the dashboard
\n","type":"text"},{"key":"gpu_count","value":"1","description":"integer
\n","type":"text"},{"key":"gpu_model","value":"rtxa4000-pcie-16gb","description":"You can get available GPU models on a hostnode from the hostnodes list API endpoint. Examples: geforcertx3090-pcie-24gb, rtxa6000-pcie-48gb, etc.
\n","type":"text"},{"key":"vcpus","value":"8","description":"Integer, must be an even number.
\n","type":"text"},{"key":"ram","value":"32","description":"Integer, must be an even number.
\n","type":"text"},{"key":"external_ports","value":"{30118, 30117}","description":"Note: make sure to include spaces between ports.
\n","type":"text"},{"key":"internal_ports","value":"{22, 80}","description":"List of integers of internal ports that should correspond to the external ports
\nNote: make sure to include spaces between ports.
\n","type":"text"},{"key":"hostnode","value":"1361d287-892b-420d-9cf5-3d9bd978ac67","description":"UUID of the hostnode you want to deploy the server on.
\n","type":"text"},{"key":"storage","value":"100","description":"integer (gigabytes)
\n","type":"text"},{"key":"operating_system","value":"Ubuntu 20.04 LTS","description":"Ubuntu 20.04 LTS, Ubuntu 22.04 LTS, TensorML 20 TensorFlow, TensorML 20 PyTorch, TensorML 20 Everything, Windows 10
\n","type":"text"},{"key":"cloudinit_script","value":"write_files:\\n - path: /home/user/cloudinit_website/index.html\\n permissions: '0777'\\n content: |\\n Woohoo! This site is working!\\n owner: user:user \\nruncmd:\\n - docker run -d --restart unless-stopped --stop-timeout 300 -v /home/user/cloudinit_website:/usr/share/nginx/html:ro -p 80:80 --name default_container nginx\n","description":"String of text to append to our cloud-init script, with newlines substituted for \\n
\n","type":"text"},{"key":"price_type","value":"spot","description":"Optional field to deploy a spot instance
\n","type":"text"},{"key":"price","value":"1.2","description":"Optional field to set bid amount for spot deployment
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/deploy/single","description":"This endpoint allows a single deployment of a machine, based on parameters you control. Pass in, via the REST body, the following variables., as shown with some examples
\nNote on networking:
\nPorts should be sent as a list structed with curly braces with commas and spaces as separators of the ports themselves. The first index of the externally requested port will forward into the first index of the internally requested port, and so on... You can view available ports for each machine through the hostnodes list API.
\nNote on authentication:
\nYou can set an SSH key and omit a password altogether. This is how most customers deploy the virtual machine, and this is the most secure method of doing so. You can pass in an SSH key during each deployment as shown below, or you can set an SSH key to be associated with each deployment by your organization here. If you have a defined an organization-wide SSH key, it will be included on each deployment, including ones initiated by other users within your organization.
\nIf you define both an SSH key and a password, you can use both to log into your server. Because password authentication is still enabled, we highly recommend disabling that in the /etc/ssh/sshd_config.d/50-cloud-init.yaml file.
Finally, if you only include a password, that you will be able to use a password to log into the server. Please set a complex password to prevent password bruteforce attacks.
\n","urlObject":{"protocol":"https","path":["api","v0","client","deploy","single"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"0a51abbe-1460-4ac8-842f-1c6eb43bf78e","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"password","value":"superC0mplexPassword","description":"Password for the VM. The username for the VM will always be \"user.\" Should not contain special characters. ","type":"text"},{"key":"name","value":"My NVIDIA RTX A4000 Server","description":"Name of your VM to be displayed in the dashboard","type":"text"},{"key":"gpu_count","value":"1","description":"integer","type":"text"},{"key":"gpu_model","value":"rtxa4000-pcie-16gb","description":"You can get available GPU models on a hostnode from the hostnodes list API endpoint","type":"text"},{"key":"vcpus","value":"8","description":"integer","type":"text"},{"key":"ram","value":"32","description":"integer","type":"text"},{"key":"external_ports","value":"{30118, 30117}","description":"list of integers of external ports","type":"text"},{"key":"internal_ports","value":"{22, 80}","description":"list of integers of internal ports that should correspond to the external ports","type":"text"},{"key":"hostnode","value":"1361d287-892b-420d-9cf5-3d9bd978ac67","description":"UUID of the hostnode you want to deploy the server on","type":"text"},{"key":"storage","value":"100","description":"integer (gigabytes)","type":"text"},{"key":"operating_system","value":"Ubuntu 20.04 LTS","description":"Examples: Ubuntu 18.04 LTS, Ubuntu 20.04 LTS","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/deploy/single"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:38:19 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7779207498680622-IAD"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n \"cost\": {\n \"compute_price\": 0.238,\n \"storage_price\": 0.005,\n \"total_price\": 0.243\n },\n \"execution_id\": 1689,\n \"ip\": \"mass-a.tensordockmarketplace.com\",\n \"port_forwards\": {\n \"30117\": \"80\",\n \"30118\": \"22\"\n },\n \"server\": \"65e7edca-888a-4e66-a975-2c6cd4cd218b\",\n \"success\": true\n}"}],"_postman_id":"27cf1f9e-a597-4046-8d86-eaee799cc36b"},{"name":"Soft Validate Spot Instance Price New Instance","id":"ea17083a-48f5-4f5a-ab73-c47bc6035f29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"gpu_count","value":"2","type":"text"},{"key":"gpu_model","value":"v100-pcie-16gb","type":"text"},{"key":"vcpus","value":"8","type":"text"},{"key":"hostnode","value":"8db2ec46-c094-4262-bc7e-6c76617f4237","type":"text"},{"key":"ram","value":"8","type":"text"},{"key":"storage","value":"200","type":"text"},{"key":"price","value":"0.2","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/spot/validate/new","description":"To validate if an interruptible instance of a given price will succeed, you can send this request.
\nIf the \"success\" field is false, then you must bid higher and confirm that enough resources are available. If the \"success\" field is true, then a deployment of the resources you selected will succeed.
\n","urlObject":{"protocol":"https","path":["api","v0","client","spot","validate","new"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"7edd41e3-ab65-440a-95a9-82cc276a0aa9","name":"Validation Succeeded - Deployment will succeed","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"gpu_count","value":"2","type":"text"},{"key":"gpu_model","value":"v100-pcie-16gb","type":"text"},{"key":"vcpus","value":"8","type":"text"},{"key":"hostnode","value":"8db2ec46-c094-4262-bc7e-6c76617f4237","type":"text"},{"key":"ram","value":"8","type":"text"},{"key":"storage","value":"200","type":"text"},{"key":"price","value":"0.25","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/spot/validate/new"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 02 Jun 2023 01:36:52 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d0bf7c34fe18cba-EWR"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"},{"id":"cc7433fe-d1a4-4b97-9989-e22fea7ca9ba","name":"Validation Failed - Attempt higher price","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"gpu_count","value":"2","type":"text"},{"key":"gpu_model","value":"v100-pcie-16gb","type":"text"},{"key":"vcpus","value":"8","type":"text"},{"key":"hostnode","value":"8db2ec46-c094-4262-bc7e-6c76617f4237","type":"text"},{"key":"ram","value":"8","type":"text"},{"key":"storage","value":"200","type":"text"},{"key":"price","value":"0.2","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/spot/validate/new"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 02 Jun 2023 01:34:07 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"18"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"500"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d0bf3bfc8e88cba-EWR"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false\n}"}],"_postman_id":"ea17083a-48f5-4f5a-ab73-c47bc6035f29"},{"name":"Soft Validate Spot Instance Price Existing Instance","id":"03fb5605-9017-4cdd-95c8-bf90354ef0a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"server","value":"vm_uuid","type":"text"},{"key":"price","value":"0.205","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/spot/validate/existing","description":"To validate if an existing VM, modified to this price, will succeed, you can send this request.
\nIf the \"success\" field is false, then you must bid higher and confirm that enough resources are available. If the \"success\" field is true, then your VM will start with the new price (or your VM will continue to run at the new price).
\n","urlObject":{"protocol":"https","path":["api","v0","client","spot","validate","existing"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"f3d1e76c-f342-4acc-9e97-d5faf2427781","name":"Validation Succeeded - New price will succeed","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"gpu_count","value":"2","type":"text","disabled":true},{"key":"gpu_model","value":"v100-pcie-16gb","type":"text","disabled":true},{"key":"vcpus","value":"8","type":"text","disabled":true},{"key":"hostnode","value":"8db2ec46-c094-4262-bc7e-6c76617f4237","type":"text","disabled":true},{"key":"ram","value":"8","type":"text","disabled":true},{"key":"storage","value":"200","type":"text","disabled":true},{"key":"price","value":"0.25","type":"text","disabled":true}]},"url":"https://dashboard.tensordock.com/api/v0/client/spot/validate/existing"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 02 Jun 2023 01:36:52 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d0bf7c34fe18cba-EWR"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"},{"id":"ffb05394-39f8-4642-ae29-c026fc0eb1ec","name":"Validation Failed - Attempt higher price","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"gpu_count","value":"2","type":"text","disabled":true},{"key":"gpu_model","value":"v100-pcie-16gb","type":"text","disabled":true},{"key":"vcpus","value":"8","type":"text","disabled":true},{"key":"hostnode","value":"8db2ec46-c094-4262-bc7e-6c76617f4237","type":"text","disabled":true},{"key":"ram","value":"8","type":"text","disabled":true},{"key":"storage","value":"200","type":"text","disabled":true},{"key":"price","value":"0.2","type":"text","disabled":true}]},"url":"https://dashboard.tensordock.com/api/v0/client/spot/validate/new"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 02 Jun 2023 01:34:07 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"18"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"500"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d0bf3bfc8e88cba-EWR"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false\n}"}],"_postman_id":"03fb5605-9017-4cdd-95c8-bf90354ef0a8"},{"name":"Your Virtual Machines","id":"c91953c1-320a-44ea-bd08-1983f2bc0073","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/list","description":"This returns a list of all current virtual machines registered under an organization.
\n","urlObject":{"protocol":"https","path":["api","v0","client","list"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"cdfb5dce-b010-4d32-9437-cc59aaf7f91f","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:46:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"77792c9c5aad7fbb-IAD"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"virtualmachines\": {\n \"10873ec1-b418-4c14-871e-37b658bd0d42\": {\n \"city\": \"Kraków\",\n \"compute_price\": \"0.364000\",\n \"cost\": 0.364,\n \"country\": \"Poland\",\n \"cpu_threadscount\": 4,\n \"dedicated_ip_address\": null,\n \"default_user\": \"user\",\n \"hostname\": \"10873ec1-b418-4c14-871e-37b658bd0d42\",\n \"hostnode\": \"c9c1c82e-2162-4d4c-ac10-6bb777788d2e\",\n \"ip_address\": \"139.28.40.249\",\n \"location\": \"b8a4dbc1-6961-4a5f-b4a3-e982681c21c7\",\n \"name\": \"4090 Server\",\n \"operating_system\": \"Ubuntu 22.04 LTS\",\n \"port_forwards\": {\n \"50604\": \"22\",\n \"50605\": \"3389\",\n \"50606\": \"8888\"\n },\n \"specs\": {\n \"gpu\": {\n \"amount\": 1,\n \"type\": \"geforcertx4090-pcie-24gb\"\n },\n \"ram\": 16,\n \"storage\": 80,\n \"vcpus\": 4\n },\n \"state\": \"Małopolska\",\n \"status\": \"Running\",\n \"storage_price\": \"0.020000\",\n \"timestamp_creation\": \"Thu, 06 Jun 2024 19:45:29 GMT\",\n \"total_price\": \"0.384000\",\n \"type\": \"ondem\"\n },\n \"b50a812f-8835-4baf-be98-a52b141353bf\": {\n \"city\": \"Austin\",\n \"compute_price\": \"0.274000\",\n \"cost\": 0.274,\n \"country\": \"United States\",\n \"cpu_threadscount\": 4,\n \"dedicated_ip_address\": null,\n \"default_user\": \"user\",\n \"hostname\": \"b50a812f-8835-4baf-be98-a52b141353bf\",\n \"hostnode\": \"c4e969a4-e3d1-4716-b966-116a16661685\",\n \"ip_address\": \"104.202.252.50\",\n \"location\": \"16c575f6-1d9c-4e7c-856b-613f3281317f\",\n \"name\": \"My Gaming Server\",\n \"operating_system\": \"Windows 10\",\n \"port_forwards\": {\n \"47900\": \"22\",\n \"47901\": \"3389\",\n \"47902\": \"8888\"\n },\n \"specs\": {\n \"gpu\": {\n \"amount\": 1,\n \"type\": \"geforcertx3090-pcie-24gb\"\n },\n \"ram\": 8,\n \"storage\": 100,\n \"vcpus\": 4\n },\n \"state\": \"Texas\",\n \"status\": \"StoppedDisassociated\",\n \"storage_price\": \"0.008000\",\n \"timestamp_creation\": \"Thu, 06 Jun 2024 19:46:24 GMT\",\n \"total_price\": \"0.282000\",\n \"type\": \"ondem\"\n }\n }\n}"}],"_postman_id":"c91953c1-320a-44ea-bd08-1983f2bc0073"},{"name":"Details of a specific VM","id":"078c606e-bacc-49e1-8027-cc206a5636a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"server","value":"","description":"UUID of the VM that you want to retrieve the details of
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/get/single","description":"Retrieve the details of a specific virtual machine.
\n","urlObject":{"protocol":"https","path":["api","v0","client","get","single"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"efcc5b3c-bf1f-4bab-b81e-555d5c1537a1","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"server","value":"","description":"UUID of the VM that you want to retrieve the details of","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/get/single"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"599"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"Werkzeug/2.0.3 Python/3.10.6"},{"key":"Date","value":"Fri, 02 Jun 2023 03:54:26 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"virtualmachine\": {\n \"cost\": 0.1,\n \"hostname\": \"217.79.242.232\",\n \"hostnode\": \"8db2ec46-c094-4262-bc7e-6c76617f4237\",\n \"location\": \"d52421f8-b264-440f-b9fb-78e05f2af72f\",\n \"name\": \"test\",\n \"operating_system\": \"Ubuntu 22.04 LTS\",\n \"port_forwards\": {\n \"60098\": \"22\"\n },\n \"specs\": {\n \"gpu\": {\n \"amount\": 8,\n \"type\": \"v100-pcie-16gb\"\n },\n \"ram\": 8,\n \"storage\": 100,\n \"vcpus\": 16\n },\n \"status\": \"Outbid\",\n \"timestamp_creation\": \"Sun, 21 May 2023 16:18:35 GMT\",\n \"type\": \"spot\"\n }\n}"}],"_postman_id":"078c606e-bacc-49e1-8027-cc206a5636a4"},{"name":"Start a VM","id":"038b5db3-3656-4f88-8152-d9651542671f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"server","value":"","description":"UUID of the VM that you want to start
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/start/single","description":"Create a request to start a server on an authorization.
\n","urlObject":{"protocol":"https","path":["api","v0","client","start","single"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"14c15cb7-cdef-4cbc-8b25-008f5558ac2a","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"server","value":"VM_UUID_HERE","description":"UUID of the VM that you want to start","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/start/single"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:50:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"777932788e708257-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"}],"_postman_id":"038b5db3-3656-4f88-8152-d9651542671f"},{"name":"Stop a VM","id":"42815f58-12fa-435c-909b-6b5c861f08f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"server","value":"","description":"UUID of the VM that you want to stop
\n","type":"text"},{"key":"disassociate_resources","value":"","description":"optional - set to \"true\" if you want to release the GPU when stopping the VM
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/stop/single","description":"Create a request to stop a server on an authorization. If the server is stopped without releasing the GPU, it will be billed at the same rate as a running server. If the GPU is released, it will only be billed for the storage costs.
\n","urlObject":{"protocol":"https","path":["api","v0","client","stop","single"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"05d6c35f-6f53-4ea7-aba5-072252593d6a","name":"Stop Server and Keep GPU","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"server","value":"VM_UUID_HERE","description":"UUID of the VM that you want to start","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/stop/single"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:50:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"777932788e708257-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"},{"id":"b1e65705-46e1-4239-a583-ee523464735a","name":"Stop Server and Release GPU","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"server","value":"VM_UUID_HERE","description":"UUID of the VM that you want to start","type":"text"},{"key":"disassociate_resources","value":"true","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/stop/single"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:50:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"777932788e708257-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"}],"_postman_id":"42815f58-12fa-435c-909b-6b5c861f08f2"},{"name":"Modify a VM","id":"84964cca-9290-4417-b77c-831495f4bed3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"server_id","value":"","type":"text","description":"UUID of the virtual machine to modify
\n"},{"key":"gpu_model","value":"","type":"text","description":"You can get available GPU models on a hostnode from the hostnodes list API endpoint. Examples: geforcertx3090-pcie-24gb, rtxa6000-pcie-48gb, etc.
\n"},{"key":"gpu_count","value":"","type":"text","description":"Number of GPUs
\n"},{"key":"ram","value":"","type":"text","description":"RAM amount
\n"},{"key":"vcpus","value":"","type":"text","description":"Number of vCPUs
\n"},{"key":"storage","value":"","type":"text","description":"Storage amount
\n"}]},"url":"https://dashboard.tensordock.com/api/v0/client/modify/single","description":"Modify the specifications of a virtual machine. Your virtual machine must be of type \"network storage\" and stopped before modifying.
\n","urlObject":{"protocol":"https","path":["api","v0","client","modify","single"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"2215e4c8-2510-4fa8-9331-f2eb47f52389","name":"Modify a VM","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"server_id","value":"cb3c501e-b85c-473d-9ab1-04dbb3e28450","type":"text"},{"key":"gpu_model","value":"rtxa6000-pcie-48gb","type":"text"},{"key":"gpu_count","value":"1","type":"text"},{"key":"ram","value":"16","type":"text"},{"key":"vcpus","value":"2","type":"text"},{"key":"storage","value":"80","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/modify/single"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"server\": \"cb3c501e-b85c-473d-9ab1-04dbb3e28450\",\n \"success\": true\n}"}],"_postman_id":"84964cca-9290-4417-b77c-831495f4bed3"},{"name":"Delete A Server","id":"b0e6fdd1-2551-4fa8-90c7-aea8d7cb6131","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"3f69a36c-06cd-4a52-b5ad-7f51de9b2c2e","type":"text"},{"key":"api_token","value":"iEc67fEz0OeM4l1zNDehG4GxPaGDPM27","type":"text"},{"key":"server","value":"","description":"UUID of the VM that you want to delete
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/delete/single","description":"Create a request to delete a server.
\n","urlObject":{"protocol":"https","path":["api","v0","client","delete","single"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"f15ee882-e32a-4c19-a19c-607be0496b6f","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"server","value":"VM_UUID_HERE","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/delete/single"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:54:58 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"777938daaae3595b-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"}],"_postman_id":"b0e6fdd1-2551-4fa8-90c7-aea8d7cb6131"},{"name":"Deploy Instant VM","id":"5ed7c116-35db-4966-8cf0-19d615638550","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"instance_uuid","value":"5255d6ed-adaf-4356-90a9-d3b766dfc471","type":"text","description":"UUID of the instance you are deploying.
\n"},{"key":"name","value":"My RTX 4000 Server","type":"text","description":"My RTX 4000 Server
\n"},{"key":"password","value":"superC0mplexPassword","type":"text","description":"Password for the VM. Optional if you have set an SSH key. The username for the VM will always be \"user\".
\n"},{"key":"ssh_key","value":"ssh-rsa AAAXB3NzaC1yc2EAAAADAQABAAABAQDFtMHOaiM9LlNlG6lrtrF+....","type":"text","description":"Either set this field, set a password, or have an SSH key stored with your organization [to override this field]
\n"},{"key":"cloudinit_script","value":"write_files:\\n - path: /home/user/cloudinit_website/index.html\\n permissions: '0777'\\n content: |\\n Woohoo! This site is working!\\n owner: user:user \\nruncmd:\\n - docker run -d --restart unless-stopped --stop-timeout 300 -v /home/user/cloudinit_website:/usr/share/nginx/html:ro -p 80:80 --name default_container nginx\n","type":"text","description":"String of text to append to our cloud-init script, with newlines substituted for \\n
\n"}]},"url":"https://dashboard.tensordock.com/api/v0/client/deployinstant/single","description":"Use this endpoint to deploy virtual machines which will be instantly avaliable.
\nNote on authentication:
\nYou can set an SSH key and omit a password altogether. This is how most customers deploy the virtual machine, and this is the most secure method of doing so. You can pass in an SSH key during each deployment as shown below, or you can set an SSH key to be associated with each deployment by your organization here. If you have a defined an organization-wide SSH key, it will be included on each deployment, including ones initiated by other users within your organization.
\nIf you define both an SSH key and a password, you can use both to log into your server. Because password authentication is still enabled, we highly recommend disabling that in the /etc/ssh/sshd_config.d/50-cloud-init.yaml file.
Finally, if you only include a password, you will be able to use a password to log into the server. Please set a complex password to prevent password bruteforce attacks.
\n","urlObject":{"protocol":"https","path":["api","v0","client","deployinstant","single"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"aa3a66cb-4923-4d20-9c76-c76f5b4a339e","name":"Deploy Instant VM","originalRequest":{"method":"GET","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"instance_uuid","value":"5255d6ed-adaf-4356-90a9-d3b766dfc471","type":"text","description":"UUID of the spot instance you are converting."},{"key":"name","value":"My RTX 4000 Server","type":"text","description":"My RTX 4000 Server"},{"key":"password","value":"superC0mplexPassword","type":"text","description":"Password for the VM. Optional if you have set an SSH key. The username for the VM will always be \"user\"."},{"key":"ssh_key","value":"ssh-rsa AAAXB3NzaC1yc2EAAAADAQABAAABAQDFtMHOaiM9LlNlG6lrtrF+....","type":"text","description":"Either set this field, set a password, or have an SSH key stored with your organization [to override this field]"},{"key":"cloudinit_script","value":"write_files:\\n - path: /home/user/cloudinit_website/index.html\\n permissions: '0777'\\n content: |\\n Woohoo! This site is working!\\n owner: user:user \\nruncmd:\\n - docker run -d --restart unless-stopped --stop-timeout 300 -v /home/user/cloudinit_website:/usr/share/nginx/html:ro -p 80:80 --name default_container nginx\n","type":"text","description":"String of text to append to our cloud-init script, with newlines substituted for \\n"}]},"url":"https://dashboard.tensordock.com/api/v0/client/deployinstant/single"},"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:38:19 GMT","description":"","type":"text"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked","description":"","type":"text"},{"key":"Connection","value":"keep-alive","description":"","type":"text"},{"key":"access-control-allow-origin","value":"*","description":"","type":"text"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b","description":"","type":"text"},{"key":"cache-control","value":"private","description":"","type":"text"},{"key":"x-do-orig-status","value":"200","description":"","type":"text"},{"key":"CF-Cache-Status","value":"DYNAMIC","description":"","type":"text"},{"key":"Server","value":"Cloudflare","description":"","type":"text"},{"key":"CF-RAY","value":"7779207498680622-IAD","description":"","type":"text"},{"key":"Content-Encoding","value":"br","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"vm\" : \"4376e897-23d0-4fa9-9ded-b87d978370fa\"\n}"}],"_postman_id":"5ed7c116-35db-4966-8cf0-19d615638550"},{"name":"Show Instant VMs","id":"9a0c6985-1e5a-4a0a-ba6f-cec29312f85e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://dashboard.tensordock.com/api/v0/client/deploy/instantvms","description":"Use this to show all currently avaliable Instant VMs
\n","urlObject":{"protocol":"https","path":["api","v0","client","deploy","instantvms"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"d175bc2e-14ff-4b81-b79f-5d761300236c","name":"Show Instant VMs","originalRequest":{"method":"GET","header":[],"url":"https://dashboard.tensordock.com/api/v0/client/deploy/instantvms"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"preconfig_options\": [\n {\n \"cpu_count\": 208,\n \"gpu_count\": [\n 8\n ],\n \"gpu_model\": [\n \"h100-sxm5-80gb\"\n ],\n \"operating_system\": \"Ubuntu 22.04 LTS\",\n \"ram\": 906,\n \"storage\": 12000,\n \"uuid\": \"d9e19f66-210a-47ea-b8dc-4c60f6e239db\"\n },\n {\n \"cpu_count\": 22,\n \"gpu_count\": [\n 1\n ],\n \"gpu_model\": [\n \"h100-sxm5-80gb\"\n ],\n \"operating_system\": \"Ubuntu 22.04 LTS\",\n \"ram\": 112,\n \"storage\": 1500,\n \"uuid\": \"583ac5b9-ee88-4e0c-91ba-d8cf6061ba19\"\n }\n ],\n \"success\": true,\n \"virtual_machines\": {\n \"04df99e1-9242-416c-88f5-16bb65bb1342\": {\n \"city\": \"Dallas\",\n \"country\": \"United States\",\n \"cpu_count\": 22,\n \"cpu_model\": \"Intel Xeon Platinum 8470\",\n \"dc_name\": \"Evoque\",\n \"dc_tier\": 3,\n \"gpu_count\": [\n 1\n ],\n \"gpu_model\": [\n \"h100-sxm5-80gb\"\n ],\n \"hostnode\": \"303d61a5-53a0-46b4-bee0-3bb1cbf29039\",\n \"location\": \"a3111bd4-550a-47d0-838a-0a52bff2ae3f\",\n \"preconfig_id\": \"583ac5b9-ee88-4e0c-91ba-d8cf6061ba19\",\n \"price\": {\n \"compute_price\": \"3.500000\",\n \"gpu_price\": \"2.920000\",\n \"price\": \"3.650000\",\n \"ram_price\": \"0.448000\",\n \"storage_price\": \"0.150000\",\n \"vcpus_price\": \"0.132000\"\n },\n \"ram\": 112,\n \"stateprovince\": \"Texas\",\n \"storage\": 1500,\n \"uptime\": \"0.9999\",\n \"uuid\": \"04df99e1-9242-416c-88f5-16bb65bb1342\"\n }\n }\n}"}],"_postman_id":"9a0c6985-1e5a-4a0a-ba6f-cec29312f85e"}],"id":"07a6c40f-fdd3-4d0f-b81d-45f7b4882ca2","_postman_id":"07a6c40f-fdd3-4d0f-b81d-45f7b4882ca2","description":""},{"name":"Containers","item":[{"name":"Deploy a Container","id":"4e0d0531-5d3c-4c46-bd32-5e5c9e646861","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"display_name","value":"","description":"The name of your container.
\n","type":"text"},{"key":"project_id","value":"","description":"The ID that will be used to identify the container on each VM.
\n","type":"text"},{"key":"image_name","value":"","description":"The name of the image to deploy on Docker Hub (e.g. strm/helloworld-http).
\n","type":"text"},{"key":"registry_type","value":"","description":"Either \"public\" or \"private\" registry. Only public images are currently supported.
\n","type":"text"},{"key":"gpu_count","value":"","description":"Number of GPUs to deploy per container replica.
\n","type":"text"},{"key":"gpu_models","value":"","description":"List of GPU models to deploy on. GPUs will be deployed in order of preference (in case a certain type of GPU is out of stock).
\n","type":"text"},{"key":"replicas","value":"","description":"Number of container replicas to deploy.
\n","type":"text"},{"key":"ram","value":"","description":"Amount of RAM per container replica.
\n","type":"text"},{"key":"vcpus","value":"","description":"Number of vCPUs per container replica.
\n","type":"text"},{"key":"storage","value":"","description":"Storage per container replica.
\n","type":"text"},{"key":"networking_port","value":"","description":"Port exposed by your Docker image (e.g. 8080).
\n","type":"text"},{"key":"environment_variables","value":"","type":"text"},{"key":"volumes","value":"","type":"text"},{"key":"arguments","value":"","type":"text"},{"key":"max_vm_rate_hourly","value":"","description":"Maximum hourly rate of each container replica.
\n","type":"text"}]},"url":"","description":"This endpoint is now deprecated. We no longer support containers.
\nCreate a request to start a server on an authorization.
\n","urlObject":{"query":[],"variable":[]}},"response":[{"id":"14014b5a-c588-4c72-9844-f39eea53fc8d","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"display_name","value":"My Container","type":"text"},{"key":"project_id","value":"my-container-id","type":"text"},{"key":"image_name","value":"strm/helloworld-http","type":"text"},{"key":"registry_type","value":"public","type":"text"},{"key":"gpu_count","value":"2","type":"text"},{"key":"gpu_models","value":"['v100-sxm2-16gb','l40-pcie-48gb']","type":"text"},{"key":"replicas","value":"2","type":"text"},{"key":"ram","value":"16","type":"text"},{"key":"vcpus","value":"4","type":"text"},{"key":"storage","value":"100","type":"text"},{"key":"networking_port","value":"80","type":"text"},{"key":"environment_variables","value":"","type":"text"},{"key":"volumes","value":"","type":"text"},{"key":"arguments","value":"","type":"text"},{"key":"max_vm_rate_hourly","value":"0.9","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/container/deploy"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:50:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"777932788e708257-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"}],"_postman_id":"4e0d0531-5d3c-4c46-bd32-5e5c9e646861"},{"name":"Scale a Container","id":"8105d2a4-b6cd-4899-afb1-0e8d9c8ab066","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"container_id","value":"","description":"ID of the container (e.g. 72d610f8-9279-4adc-b9a2-28a36b98e42b).
\n","type":"text"},{"key":"replicas","value":"","description":"Number of replicas to add to the container group. Specify a negative number to scale down a container.
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/container/scale","description":"This endpoint is now deprecated. We no longer support containers.
\nCreate a request to start a server on an authorization.
\n","urlObject":{"protocol":"https","path":["api","v0","client","container","scale"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"62e7f7f4-228a-4580-b799-1fa7452acda4","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"container_id","value":"CONTAINER_UUID_HERE","description":"UUID of the VM that you want to scale","type":"text"},{"key":"replicas","value":"2","description":"Number of replicas to add","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/start/single"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:50:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"777932788e708257-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"}],"_postman_id":"8105d2a4-b6cd-4899-afb1-0e8d9c8ab066"},{"name":"Terminate a Container","id":"a8e89e2a-ad52-4617-a5a0-85d888674dd5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"container_id","value":"","description":"UUID of the container (e.g. 72d610f8-9279-4adc-b9a2-28a36b98e42b).
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/container/stop","description":"This endpoint is now deprecated. We no longer support containers.
\nCreate a request to start a server on an authorization.
\n","urlObject":{"protocol":"https","path":["api","v0","client","container","stop"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"4eca8874-e990-419b-aaf4-9b9625c3329f","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"API_KEY_HERE","type":"text"},{"key":"api_token","value":"API_TOKEN_HERE","type":"text"},{"key":"container_id","value":"CONTAINER_UUID_HERE","description":"UUID of the container","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/client/container/stop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 10 Dec 2022 21:50:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"17"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-do-app-origin","value":"4c11256b-e628-475c-9f86-b235da9b473b"},{"key":"cache-control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"777932788e708257-IAD"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true\n}"}],"_postman_id":"a8e89e2a-ad52-4617-a5a0-85d888674dd5"},{"name":"Retrieve a Container's Replicas","id":"1f3adae5-e70b-47e6-9e69-07210d1a86a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text","disabled":true},{"key":"api_token","value":"","type":"text","disabled":true}]},"url":"https://dashboard.tensordock.com/api/v0/client/container/This endpoint is now deprecated. We no longer support containers.
\nCreate a request to start a server on an authorization.
\n","urlObject":{"protocol":"https","path":["api","v0","client","container","Through this endpoint, you can easily retrieve your current balance and current spending rate to monitor your balance.
\nRemember, once your balance runs out, your servers are automatically deleted — so please constantly monitor and understand your billing situation to ensure that this does not occur.
\n","urlObject":{"protocol":"https","path":["api","v0","billing","balance"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"f06467b0-0d2d-4721-91be-ea0d4e420d2f","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/billing/balance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"balance\": 999.987,\n \"hourly_cost\": 0.856,\n \"success\": true\n}"}],"_postman_id":"0b589a92-2c56-4bc9-92f4-93f86c966a3e"}],"id":"974693a4-6f60-44c0-95db-49cd8a9c4e46","_postman_id":"974693a4-6f60-44c0-95db-49cd8a9c4e46","description":""},{"name":"Hosting Providers","item":[{"name":"Retrieve Revenue","event":[{"listen":"test","script":{"id":"45390793-0124-48b8-b3ba-3a2ee3129471","exec":[""],"type":"text/javascript","packages":{}}}],"id":"3d45e98a-e9cf-4de7-9d15-168002f4f8ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"start_timestamp","value":"","description":"Start timestamp of the period to retrieve historical data for.
\n","type":"text"},{"key":"end_timestamp","value":"","description":"End timestamp of the period to retrieve historical data for.
\n","type":"text"},{"key":"hostnode_id","value":"","description":"Hostnode to filter data by.
\n","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/billing/revenue","description":"Through this endpoint, you can easily retrieve your revenue per hostnode. It also returns all running virtual machines on each hostnode.
\n","urlObject":{"protocol":"https","path":["api","v0","billing","revenue"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"a7bf6087-067d-4333-b243-f94bf4a0c39a","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/billing/revenue"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"data\": [\n \t{\n \"hostnode_id\": \"7d3a07b6-de25-44a2-a9f4-1cd241fa0d0f\",\n \"location\": \"Chicago, Illinois, United States\",\n \"used_storage\": 30,\n \"used_gpus\": 3,\n \"used_cpus\": 2,\n \"used_ram\": 10,\n \"available_storage\": 170,\n \"available_gpus\": 1,\n \"available_cpus\": 3,\n \"available_ram\": 50,\n \"revenue_storage\": 0.03,\n \"revenue_compute\": 1.03,\n \"virtual_machines\": [\n {\n \"id\": \"f2467993-1f6b-43b2-8744-7b14dfc0bdab\",\n \"used_storage\": 20,\n \"used_gpus\": 1,\n \"used_cpus\": 1,\n \"used_ram\": 5,\n \"revenue_storage\": 0.03,\n \"revenue_compute\": 1.03\n }\n ]\n }\n ]\n}"}],"_postman_id":"3d45e98a-e9cf-4de7-9d15-168002f4f8ef"},{"name":"Retrieve Monthly Summary","event":[{"listen":"test","script":{"id":"45390793-0124-48b8-b3ba-3a2ee3129471","exec":[""],"type":"text/javascript","packages":{}}}],"id":"e5f65960-ba6f-47f1-8216-2cef60d56bb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"period","value":"","description":"Billing period to retrieve transactions for. Accepts date in format of YYYY-MM (e.g. 2024-01).
\n","type":"text"},{"key":"","value":"","type":"text","disabled":true}]},"url":"https://dashboard.tensordock.com/api/v0/billing/summary","description":"Roll up earnings on a monthly basis to gain better hosting insights
\n","urlObject":{"protocol":"https","path":["api","v0","billing","summary"],"host":["dashboard","tensordock","com"],"query":[],"variable":[]}},"response":[{"id":"32e00192-a88d-41aa-bbdc-c6c09ded28e3","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"api_key","value":"","type":"text"},{"key":"api_token","value":"","type":"text"},{"key":"period","value":"2024-01","type":"text"}]},"url":"https://dashboard.tensordock.com/api/v0/billing/summary"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"bill_period\": {\n\t\t\"endM\": \"03\",\n\t\t\"endY\": \"2024\",\n\t\t\"startM\": \"02\",\n\t\t\"startY\": \"2024\"\n\t},\n\t\"changes\": {\n\t\t\"expenses\": \"332.15\",\n\t\t\"payouts\": \"9304.01\"\n\t},\n\t\"final_balance\": \"929.41\",\n\t\"organization_billing_address\": null,\n\t\"organization_tax_id\": \"37-3294571\",\n\t\"previous_balance\": \"1765.06\",\n\t\"transactions\": {\n\t\t\"deposits\": [],\n\t\t\"storage_expenses\": [],\n\t\t\"storage_payouts\": [\n\t\t\t{\n\t\t\t\t\"billing_period_end\": \"03/01\",\n\t\t\t\t\"billing_period_start\": \"02/01\",\n\t\t\t\t\"hostnode_id\": \"2f0b8e32-b3e9-44ca-b3ca-8afa4c1320bf\",\n\t\t\t\t\"rate_hourly\": 0.01,\n\t\t\t\t\"storage_amount\": 200,\n\t\t\t\t\"total_amount\": 5.42,\n\t\t\t\t\"virtual_machine_id\": \"d7e95e9c-9af2-43b0-a413-1141c97a9cc9\"\n\t\t\t}\n\t\t],\n\t\t\"vm_expenses\": [],\n\t\t\"vm_payouts\": [\n\t\t\t{\n\t\t\t\t\"billing_period_end\": \"03/01\",\n\t\t\t\t\"billing_period_start\": \"02/01\",\n\t\t\t\t\"gpu_details\": \"1x L40 48 GB\",\n\t\t\t\t\"hostnode_id\": \"2f0b8e32-b3e9-44ca-b3ca-8afa4c1320bf\",\n\t\t\t\t\"rate_hourly\": 1.56,\n\t\t\t\t\"total_amount\": 544.312,\n\t\t\t\t\"virtual_machine_id\": \"d7e95e9c-9af2-43b0-a413-1141c97a9cc9\"\n\t\t\t}\n\t\t],\n\t\t\"withdrawals\": []\n\t}\n}"}],"_postman_id":"e5f65960-ba6f-47f1-8216-2cef60d56bb1"}],"id":"97eaa260-394b-441b-913c-d42e549791e4","_postman_id":"97eaa260-394b-441b-913c-d42e549791e4","description":""}],"id":"7aaedbe3-4440-4028-bcd9-81d59df3610f","_postman_id":"7aaedbe3-4440-4028-bcd9-81d59df3610f","description":""}],"variable":[{"key":"token","value":"Kb00pWJIobs4yH3jmqMN1rM8GpypIn6L"}]}