Report Machine Problem

Submits a problem report for a machine on which the authenticated user has an active instance, and notifies the machine owner.

PUT /api/v0/machines/{machine_id}/report

Report Machine Problem

cURL

curl --request PUT \
  --url https://console.vast.ai/api/v0/machines/{machine_id}/report \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "GPU utilization never exceeded 20% despite benchmark workload.",
  "instance_id": 67890
}
'

import requests

url = "https://console.vast.ai/api/v0/machines/{machine_id}/report"

payload = {
    "message": "GPU utilization never exceeded 20% despite benchmark workload.",
    "instance_id": 67890
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: 'GPU utilization never exceeded 20% despite benchmark workload.',
    instance_id: 67890
  })
};

fetch('https://console.vast.ai/api/v0/machines/{machine_id}/report', 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://console.vast.ai/api/v0/machines/{machine_id}/report",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => 'GPU utilization never exceeded 20% despite benchmark workload.',
    'instance_id' => 67890
  ]),
  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://console.vast.ai/api/v0/machines/{machine_id}/report"

	payload := strings.NewReader("{\n  \"message\": \"GPU utilization never exceeded 20% despite benchmark workload.\",\n  \"instance_id\": 67890\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://console.vast.ai/api/v0/machines/{machine_id}/report")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"GPU utilization never exceeded 20% despite benchmark workload.\",\n  \"instance_id\": 67890\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://console.vast.ai/api/v0/machines/{machine_id}/report")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"GPU utilization never exceeded 20% despite benchmark workload.\",\n  \"instance_id\": 67890\n}"

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

200

{
  "success": true
}

{
  "error": "<string>",
  "msg": "<string>"
}

{
  "error": "<string>",
  "msg": "<string>"
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Path Parameters

machine_id · integer · required

Numeric ID of the machine being reported; must match the URL path segment.

Body

application/json

message · string

Optional free-text description of the issue, truncated to 512 characters.

Example:

"GPU utilization never exceeded 20% despite benchmark workload."

instance_id · integer

ID of the caller's active instance on this machine, used to verify the caller is a current tenant.

Example:

67890

problem · enum<string>

Category of problem being reported.

Available options: Unable To Start Instance, Instance Takes Too Long To Load, Instance Has Less Disk Space Than Requested, Machine Has Port Issues, Machine Performance Is Less Than Expected, Other

Response

200

application/json

Report submitted successfully; returns {"success": true}

success · boolean · required

Always true on success