ScoutsList scouts

List scouts

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/scouts?location_id=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "location_id": "example_string",
      "name": "John Doe",
      "skill": "error_tracking",
      "instructions": "example_string",
      "schedule": {
        "kind": "daily",
        "time": "08:00",
        "day_of_week": 42,
        "timezone": "America/New_York"
      },
      "delivery": {
        "channel_ids": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      },
      "model": "example_string",
      "provider": "openrouter",
      "enabled": true,
      "version": 42,
      "next_run_at": "2024-12-25T10:00:00Z",
      "last_run_at": "2024-12-25T10:00:00Z",
      "last_report_at": "2024-12-25T10:00:00Z",
      "last_error": "example_string",
      "current_run": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "status": "pending",
        "scheduled_for": "2024-12-25T10:00:00Z",
        "triggered_by": "schedule",
        "attempts": 42
      },
      "can_run_now": true,
      "created_at": "2024-12-25T10:00:00Z",
      "updated_at": "2024-12-25T10:00:00Z"
    }
  ]
}
GET
/client/v1/scouts
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.
query
location_idstring

Only this client's scouts. Omit for every client.

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.

Query Parameters

location_idstring

Only this client's scouts. Omit for every client.

Responses

successboolean
dataarray