Replay VisionUpdate a scanner

Update a scanner

type and location_id cannot change. A change to prompt, config or model increments version; re-sending the same values does not. A model of the other provider than the client's key gets 422 model_provider_mismatch. Re-enabling sweeps from now on.

curl -X PATCH "https://mythic-analytics.gulp.workers.dev/client/v1/replay-vision/scanners/123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "name": "John Doe",
  "prompt": "example_string",
  "config": {},
  "filters": {},
  "sampling_rate": 3.14,
  "model": "example_string",
  "monthly_scan_limit": 42,
  "enabled": true
}'
{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "location_id": "example_string",
    "name": "John Doe",
    "type": "monitor",
    "prompt": "example_string",
    "config": {},
    "filters": {},
    "sampling_rate": 3.14,
    "model": "example_string",
    "monthly_scan_limit": 42,
    "enabled": true,
    "version": 42,
    "last_swept_at": "2024-12-25T10:00:00Z",
    "last_error": "example_string",
    "created_at": "2024-12-25T10:00:00Z",
    "updated_at": "2024-12-25T10:00:00Z"
  }
}
PATCH
/client/v1/replay-vision/scanners/{id}
PATCH
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 replay_vision:read or replay_vision:write.

Agency key (ak_) only; a location secret key (sk_) gets 403 agency_required. Agency-wide scoped keys (mcp_) need replay_vision:read or replay_vision:write.
Content-Typestring
Required

The media type of the request body

Options: application/json
namestring
Max length: 120
promptstring

The question. Required except for summarizer, where it is optional context.

Max length: 4000
configobject

monitor {allow_inconclusive}; classifier {tags (2-30, lowercase), multiple, freeform}; scorer {min, max, label}; summarizer {length: short|medium|long}.

filtersobject

Sweep filters: device_type, utm_source, utm_medium, utm_campaign, landing_page, country, browser, os (exact strings) and min_duration_s.

sampling_ratenumber
Min: 0 • Max: 1
modelstring

Model id of the key's provider. Null uses the key's default_model.

monthly_scan_limitinteger
Min: 1 • Max: 100000
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 replay_vision:read or replay_vision:write.

Path Parameters

Body

application/json
promptstring

The question. Required except for summarizer, where it is optional context.

configobject

monitor \\{allow_inconclusive\\}; classifier \\{tags (2-30, lowercase), multiple, freeform\\}; scorer \\{min, max, label\\}; summarizer \\{length: short|medium|long\\}.

filtersobject

Sweep filters: device_type, utm_source, utm_medium, utm_campaign, landing_page, country, browser, os (exact strings) and min_duration_s.

modelstring

Model id of the key's provider. Null uses the key's default_model.

Responses

successboolean
dataobject