TensorDock

API Documentation

Learn how to integrate with our API to manage your virtual machines and resources.

Instance Management

Endpoints for managing virtual machine instances

List Instances
Get a list of all virtual machine instances
GET/api/v2/instances

Response

{
  "data": {
    "instances": [
      {
        "type": "VM",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "attributes": {
          "name": "My Instance",
          "status": "running"
        }
      }
    ]
  }
}
Get Instance
Get details about a specific instance
GET/api/v2/instances/{id}

Parameters

  • id - The ID of the instance to retrieve

Response

{
  "type": "instance",
  "id": "string",
  "name": "string",
  "status": "string",
  "ipAddress": "string",
  "portForwards": [
    {
      "internal_port": "number",
      "external_port": "number"
    }
  ]
}
Start Instance
Start a stopped instance
POST/api/v2/instances/{id}/start

Parameters

  • id - The ID of the instance to start

Response

{
  "data": {
    "type": "instance",
    "id": "string",
    "attributes": {
      "status": "starting"
    }
  }
}
Stop Instance
Stop a running instance
POST/api/v2/instances/{id}/stop

Parameters

  • id - The ID of the instance to stop

Response

{
  "data": {
    "type": "instance",
    "id": "string",
    "attributes": {
      "status": "stopping"
    }
  }
}
Delete Instance
Delete an instance and its associated resources
DELETE/api/v2/instances/{id}

Parameters

  • id - The ID of the instance to delete

Response

{
  "data": {
    "type": "success",
    "attributes": {
      "message": "Instance deleted successfully"
    }
  }
}
Modify Instance
Modify the resources of a stopped or stopped-disassociated instance
PUT/api/v2/instances/{id}/modify

Requirements

  • Instance Status - Instance must be in 'Stopped' or 'StoppedDisassociated' state
  • Resource Steps - CPU cores must be in steps of 2, RAM in steps of 8GB, Storage in steps of 50GB (min 100GB)
  • Storage Limitation - Storage can only be increased, never decreased

Parameters

  • id - The ID of the instance to modify

Request Body

{
  "cpuCores": 8,
  "ramGb": 32,
  "diskGb": 200,
  "gpus": {
    "gpuV0Name": "geforcertx4090-pcie-24gb",
    "count": 1
  }
}

Response

{
  "message": "Instance modified successfully"
}