Scoutpost

Fetch a single project by id.

Fetch a single scout by id.

Get a short-lived (5 min) signed download URL for one artifact of a snapshot. Artifacts: mhtml (full captured page, opens in Chrome/Edge), screenshot (png), rawhtml, markdown, manifest (JSON of per-artifact SHA-256 hashes), tsr (RFC 3161 timestamp token). Every URL downloads as an attachment. Returns 404 if the snapshot lacks that artifact (e.g. mhtml on a markdown_only capture) — call list_snapshots first to see each snapshot's `artifacts`.

Fetch a single information unit by id.

Read owner-scoped bounded exact evidence expressions for one canonical unit. Use this to verify any AI-extracted Civic lead against its official source before publication.

Ingest a URL or raw text into the knowledge base. Creates a raw_capture row and extracts atomic information_units with Gemini through OpenRouter's Google Vertex route.

List owner-scoped Civic accountability items. Promises have a human lifecycle status and due date; decisions are completed adopted actions and never enter the promise tracker.

List safe aggregate diagnostics for Civic runs, including policy version, semantic-zero state, counts, and rejection aggregates without exposing rejected source text or private criteria.

List investigation projects owned by the caller.

List editorial reflections (agent-written synthesized summaries) owned by the caller.

List all scouts owned by the caller (id, name, type, schedule, is_active).

List evidence-archive snapshots for the caller's Web/Page scouts, newest first. Each row: id, scout_id, captured_at, capture_kind (baseline|change), fidelity (full|rendered_thirdparty|markdown_only), sizes, trust (RFC 3161 timestamp status + Wayback status/url), and the `artifacts` available to download. Filter by scout_id. Snapshots exist only for scouts with archiving enabled (create_scout/update_scout archive_enabled).

List information units owned by the caller. Supports project, scout, verification, usage, and deleted-state filters.

Flag a unit as used in a published article so it leaves the inbox. Optionally record the URL and timestamp.

Collapse duplicate entities into a single keeper. Use after `search_entities` surfaces near-duplicates.

Pause a scout: set is_active=false and unschedule its cron job.

Step 2 (sample) for Civic Scout creation, after discover_civic_sources and before create_scout. Read-only preview of 1-2 listing URLs: resolves meeting documents, parses at most two, runs one extraction pass and returns sample_items plus preview_snapshot_token (pass it to create_scout with import_current_items). Returns dated promises to follow and adopted material decisions; a valid empty result means no accountable item was found. Response carries the probe envelope { ok, stage:'sample', error_code?, error? } with valid and documents_found; ok:false codes are no_documents, unreachable (a linked meeting could not be fetched), parse_failed or model_failed. Every result is an AI-extracted lead that must be checked against the cited official source.

Reject a unit (not wanted editorially). Sets verified=false and records the reason in verification_notes.

Resume a paused scout: set is_active=true and re-schedule its cron job.

Trigger an on-demand scout run. Spends credits. Returns 202 + run_id.

Find canonical entities (people, orgs, places, policies) across the knowledge base. Returns entity rows with type + canonical_name.

Semantic search over the caller's reflections.

Search the caller's information units. Modes: semantic, keyword, or hybrid. Supports project, scout, verification, usage, and deleted-state filters.

Apply a human editorial Civic-promise transition. Civic extraction never makes this judgment. Read first and pass its exact updated_at as expected_updated_at.

Step 1 for Fleet Scout creation. Test a transport config against current live data without creating a scout or spending credits. Returns baseline_ids and a compact preview. Pass those baseline_ids as transport_baseline_ids to create_scout in Step 2 so objects already present do not alert immediately. Hosted Scoutpost requires Pro/Team.

Step 1 for Page (web) Scout creation. Probe a URL the way create_scout will: one fresh scrape plus an optional criteria check, no scout created, no baseline stored. Returns the shared probe envelope { ok, stage:'reach', error_code?, error? } alongside summary, scraper_status and criteria_status. ok:false carries error_code unreachable|blocked|empty_content|outside_configured_page|page_too_long and a human-readable error — create_scout would reject the same URL with HTTP 422, so fix the URL first. criteria_not_met is advisory: ok stays true and the scout can still be created. Run this before create_scout for type=web.

Patch a project — name, description, visibility, or tags.

Patch an existing scout. All fields optional; only sent keys change. Keep topic as 1-3 short comma-separated tags; put longer context in description and filtering/notification rules in criteria. A scout must retain either location or topic (transport scouts are scoped by config instead). For Fleet Scouts, pass a full replacement config with the required circle area; it alerts when watched objects enter that area, with criteria only as an optional post-entry filter. Fleet Scout configuration is Pro/Team-only on hosted Scoutpost. For web/page scouts, toggle evidence archiving with archive_enabled / wayback_enabled (archive_enabled is Pro/Team-gated).

Verify a unit (accept it for editorial use). Sets verified=true, optional verification_notes and verified_by.