Scout model spend
Reported BYOK spend on scout model calls, counting every provider call including failed and repaired ones. Totals plus one row per scout. Calls whose cost the provider did not report are counted in unknown_cost_calls; the provider's bill is authoritative.
curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/scouts/usage?location_id=example_string&date_from=2024-12-25&date_to=2024-12-25" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://mythic-analytics.gulp.workers.dev/client/v1/scouts/usage?location_id=example_string&date_from=2024-12-25&date_to=2024-12-25"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://mythic-analytics.gulp.workers.dev/client/v1/scouts/usage?location_id=example_string&date_from=2024-12-25&date_to=2024-12-25", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://mythic-analytics.gulp.workers.dev/client/v1/scouts/usage?location_id=example_string&date_from=2024-12-25&date_to=2024-12-25", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://mythic-analytics.gulp.workers.dev/client/v1/scouts/usage?location_id=example_string&date_from=2024-12-25&date_to=2024-12-25')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"success": true,
"data": {
"date_from": "2024-12-25",
"date_to": "2024-12-25",
"spend_label": "Reported spend on scout model calls",
"totals": {
"runs": 42,
"calls": 42,
"known_cost_usd": 3.14,
"unknown_cost_calls": 42,
"input_tokens": 42,
"output_tokens": 42
},
"scouts": [
{
"scout_id": "123e4567-e89b-12d3-a456-426614174000",
"location_id": "example_string",
"runs": 42,
"calls": 42,
"known_cost_usd": 3.14,
"unknown_cost_calls": 42
}
]
}
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Forbidden",
"message": "You don't have permission to access this resource",
"code": 403
}
/client/v1/scouts/usage
Target server for requests. Edit to use your own host.
Agency key (ak_) only; a location secret key (sk_) gets 403 agency_required. Agency-wide scoped keys (mcp_) need scouts:read or scouts:write, plus the read scope of every surface a scout's skill reads to create or run it, and of every surface a report's run read to open it.
ak_) only; a location secret key (sk_) gets 403 agency_required. Agency-wide scoped keys (mcp_) need scouts:read or scouts:write, plus the read scope of every surface a scout's skill reads to create or run it, and of every surface a report's run read to open it.Only this client.
Inclusive UTC date. Default: the first day of this month.
Inclusive UTC date. Default: today. At most 92 days after date_from.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Agency key (ak_) only; a location secret key (sk_) gets 403 agency_required. Agency-wide scoped keys (mcp_) need scouts:read or scouts:write, plus the read scope of every surface a scout's skill reads to create or run it, and of every surface a report's run read to open it.
Query Parameters
Only this client.
Inclusive UTC date. Default: the first day of this month.
Inclusive UTC date. Default: today. At most 92 days after date_from.