ScoutsGet a report

Get a report

One report with its summary, actionability explanation, suggested action, status history and evidence. Needs the read scope of every surface in families (403 insufficient_scope with required). A report that read server logs is refused on HIPAA locations (403 hipaa_restricted) and while the location's privacy mode cannot be read (503 privacy_unknown).

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/scouts/reports/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",
    "location_id": "example_string",
    "scout_id": "123e4567-e89b-12d3-a456-426614174000",
    "scout_name": "John Doe",
    "skill": "example_string",
    "run_id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "example_string",
    "priority": "P0",
    "actionability": "immediately_actionable",
    "status": "open",
    "dedupe_key": "exceptions:4f2a9c",
    "families": [
      "example_string"
    ],
    "snoozed_until": "2024-12-25T10:00:00Z",
    "dismiss_reason": "example_string",
    "created_at": "2024-12-25T10:00:00Z",
    "updated_at": "2024-12-25T10:00:00Z",
    "status_changed_at": "2024-12-25T10:00:00Z",
    "edit_count": 10,
    "summary_md": "example_string",
    "actionability_explanation": "example_string",
    "suggested_action": "example_string",
    "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"
      }
    ],
    "history": [
      {
        "at": "2024-12-25T10:00:00Z",
        "kind": "filed",
        "run_id": "123e4567-e89b-12d3-a456-426614174000",
        "scout_id": "123e4567-e89b-12d3-a456-426614174000",
        "status": "example_string",
        "by": "example_string",
        "note": "example_string"
      }
    ],
    "provider": "example_string",
    "model_used": "example_string"
  }
}
GET
/client/v1/scouts/reports/{id}
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.

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.
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