Get a run

One run, as in the list. A dry run also returns drafts: the reports it would have filed (kind: new) and the edits it would have made (kind: edit). A run that read surfaces the caller cannot read comes back restricted, without drafts.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/scouts/123e4567-e89b-12d3-a456-426614174000/runs/123e4567-e89b-12d3-a456-426614174000" \
  -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/123e4567-e89b-12d3-a456-426614174000/runs/123e4567-e89b-12d3-a456-426614174000"
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/123e4567-e89b-12d3-a456-426614174000/runs/123e4567-e89b-12d3-a456-426614174000", {
  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/123e4567-e89b-12d3-a456-426614174000/runs/123e4567-e89b-12d3-a456-426614174000", 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/123e4567-e89b-12d3-a456-426614174000/runs/123e4567-e89b-12d3-a456-426614174000')
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": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "pending",
    "triggered_by": "schedule",
    "dry_run": true,
    "draft_count": 10,
    "skip_reason": "example_string",
    "scheduled_for": "2024-12-25T10:00:00Z",
    "attempts": 42,
    "provider": "example_string",
    "model_used": "example_string",
    "skills_version": "example_string",
    "steps": 42,
    "tool_calls": 42,
    "reports_filed": 42,
    "reports_edited": 42,
    "families_read": [
      "example_string"
    ],
    "summary": "example_string",
    "restricted": {
      "reason": "insufficient_scope",
      "required": "example_string"
    },
    "error": "example_string",
    "created_at": "2024-12-25T10:00:00Z",
    "completed_at": "2024-12-25T10:00:00Z",
    "model_calls": 42,
    "known_cost_usd": 3.14,
    "unknown_cost_calls": 42,
    "drafts": [
      {
        "draft": 42,
        "kind": "new",
        "at": "2024-12-25T10:00:00Z",
        "title": "example_string",
        "summary_md": "example_string",
        "priority": "P0",
        "actionability": "immediately_actionable",
        "actionability_explanation": "example_string",
        "suggested_action": "example_string",
        "dedupe_key": "example_string",
        "status": "open",
        "report_id": "123e4567-e89b-12d3-a456-426614174000",
        "report_title": "example_string",
        "note": "example_string",
        "recheck_after_days": 42,
        "evidence": [
          {
            "call_id": "c4",
            "run_id": "123e4567-e89b-12d3-a456-426614174000",
            "tool": "get_exception_digest",
            "family": "exceptions",
            "args": {},
            "status": 200,
            "truncated": true,
            "excerpt": "example_string",
            "note": "example_string",
            "added_at": "2024-12-25T10:00:00Z"
          }
        ],
        "signal_ids": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      }
    ]
  }
}

GET

/client/v1/scouts/{id}/runs/{runId}

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

Bearer Tokenstring

Required

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.

Format: uuid

Format: uuid

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

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.

Path Parameters

Responses

successboolean

datastring

Was this page helpful?

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/scouts/123e4567-e89b-12d3-a456-426614174000/runs/123e4567-e89b-12d3-a456-426614174000" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_TOKEN"

{ "success": true, "data": { "id": "123e4567-e89b-12d3-a456-426614174000", "status": "pending", "triggered_by": "schedule", "dry_run": true, "draft_count": 10, "skip_reason": "example_string", "scheduled_for": "2024-12-25T10:00:00Z", "attempts": 42, "provider": "example_string", "model_used": "example_string", "skills_version": "example_string", "steps": 42, "tool_calls": 42, "reports_filed": 42, "reports_edited": 42, "families_read": [ "example_string" ], "summary": "example_string", "restricted": { "reason": "insufficient_scope", "required": "example_string" }, "error": "example_string", "created_at": "2024-12-25T10:00:00Z", "completed_at": "2024-12-25T10:00:00Z", "model_calls": 42, "known_cost_usd": 3.14, "unknown_cost_calls": 42, "drafts": [ { "draft": 42, "kind": "new", "at": "2024-12-25T10:00:00Z", "title": "example_string", "summary_md": "example_string", "priority": "P0", "actionability": "immediately_actionable", "actionability_explanation": "example_string", "suggested_action": "example_string", "dedupe_key": "example_string", "status": "open", "report_id": "123e4567-e89b-12d3-a456-426614174000", "report_title": "example_string", "note": "example_string", "recheck_after_days": 42, "evidence": [ { "call_id": "c4", "run_id": "123e4567-e89b-12d3-a456-426614174000", "tool": "get_exception_digest", "family": "exceptions", "args": {}, "status": 200, "truncated": true, "excerpt": "example_string", "note": "example_string", "added_at": "2024-12-25T10:00:00Z" } ], "signal_ids": [ "123e4567-e89b-12d3-a456-426614174000" ] } ] } }