WorkspaceOverview
API disconnected

EVIDENCE-FIRST WEB INTELLIGENCE

Discover what the web says.
Keep the evidence.

Investigate across sources, inspect acquisition provenance, and keep every finding connected to its evidence.

Authentication required

Live investigation submission is available only after the approved Platform identity flow completes and deployment runtime settings are valid. No fixture data is presented as live activity.

START WITH A QUESTION

Investigation workspace

01 / INVESTIGATE
NEW INVESTIGATIONNot connected

What do you need to find?

Submit a supported search, fetch, or browser job to TWI. Results reflect captured observations—not an independent verdict about factual truth.

1–400 characters

Requests are authenticated, tenant-scoped, and sent with an idempotency key. The service enforces acquisition policy.

EVIDENCE STANDARD

Evidence before conclusions.

  • 01Source attributionFindings remain linked to where they came from.
  • 02Acquisition provenanceInspect how and when content was captured when the API provides it.
  • 03Honest uncertaintyConflicts and unknowns stay visible; retrieval is not proof of truth.

WORKSPACE MAP

Designed around the evidence lifecycle

02 / NAVIGATION
RUN INSPECTIONTenant-scoped

Inspect an existing run

Enter a job ID to retrieve its current service-reported state. Access remains subject to Platform scopes and TWI tenant/subject authorization.

CAPTURED EVIDENCEAwaiting package

Evidence package

No evidence package loaded.

The package records an acquisition observation. Content integrity validation does not establish source truth or source authority. Raw source URLs are not included in the package metadata.

CLAIM VERIFICATIONCitation matching

Check a claim against captured text

Submit one claim and one to four citations. Each quote is compared with captured text from a successful fetch or browser job. A quote match is not a factual-truth verdict.

Citations

1 / 4

Use an exact quote from captured text (8–350 characters) and the job ID of the successful fetch or browser job that captured it. The API enforces tenant and subject scope.

Citation 1

Sign in with the approved Platform identity provider to verify claims against accessible captured evidence.

CHANGE MONITORSExplicit runs only

Monitor a public web target

Monitors store a tenant- and subject-scoped target and compare captured text digests. This interface starts runs only when you ask; recurrence belongs to Agent OS. TWI does not return the target URL in monitor responses.

Use a public HTTP(S) URL. The server enforces the safe acquisition policy. Do not include credentials or secrets in URLs; query values are not echoed by the API.

There is no monitor-list endpoint in the current API. Load a monitor by its ID; this page does not invent or persist a list of recent monitors.

Sign in with the approved Platform identity provider to create or inspect tenant-scoped monitors.

DEVELOPER REFERENCEAPI v1

Build on the TWI contracts

Use the documented HTTP API with a Platform-issued access token whose audience is the configured TWI API. These examples describe existing contracts; they do not create credentials or prove that a deployment is configured.

Security boundary

Never paste access tokens into this page, commit them to source control, or place them in URLs. Obtain tokens through the configured Platform identity flow or an approved trusted runtime. Tenant, subject, scopes, acquisition policy and idempotency are enforced by TWI.

Supported endpoints

  • POST /v1/jobs — create search, fetch, or browser jobs; requires Idempotency-Key and matching twi:search, twi:fetch, or twi:browser scope.
  • GET /v1/jobs/{job_id} — inspect a tenant-scoped job with twi:jobs:read.
  • POST /v1/jobs/{job_id}/cancel — request cooperative cancellation with twi:jobs:cancel.
  • GET /v1/jobs/{job_id}/evidence — export a successful in-scope fetch job with twi:evidence:export.
  • POST /v1/research/verify — compare bounded citations against captured text with twi:research:verify.
  • /v1/monitors — create/read monitors and explicitly enqueue, inspect, pause, resume, or delete using documented monitor scopes.
  • GET /v1/usage — read bounded tenant-scoped usage facts with twi:usage:read or twi:usage:read:any.

Create a search job

curl --fail-with-body --request POST "$TWI_API_BASE_URL/v1/jobs" \
  --header "Authorization: Bearer $TWI_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $TWI_IDEMPOTENCY_KEY" \
  --data '{"kind":"search","payload":{"query":"primary sources for a published claim","limit":5}}'

Set variables in your trusted runtime. Use a fresh idempotency key for a new logical operation; reuse it only when retrying that same request.

Verify captured citations

curl --fail-with-body --request POST "$TWI_API_BASE_URL/v1/research/verify" \
  --header "Authorization: Bearer $TWI_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"claims":[{"claim_id":"claim-1","statement":"The source makes this statement.","citations":[{"job_id":"REPLACE_WITH_CAPTURED_JOB_ID","quote":"REPLACE_WITH_AN_EXACT_QUOTE_FROM_CAPTURED_TEXT"}]}]}'

Verification reports quote matching against captured text. It does not assess factual truth or source authority. Replace template values with a real, accessible captured job.

Examples are templates. No request is sent from this reference panel.

Canonical details: docs/api/jobs-v1.md, docs/api/evidence-packages-v1.md, and docs/api/monitors-v1.md. Browser access requires a configured same-origin reverse proxy or explicitly approved HTTPS API origin.

USAGE & ENTITLEMENTSTenant-scoped API

Inspect committed usage

Read usage facts for the authenticated Platform principal. Tenant and subject are derived by TWI from the verified token; this screen does not allow identity switching or administer tenants.

Scope and billing boundary

Requires twi:usage:read or twi:usage:read:any. Usage facts and configured quotas are not invoice balances, payment settlement, tax, refunds, or provider billing status. Unsupported tenant-administration and credential-management actions are not exposed.

Sign in with the approved Platform identity provider and provide a period start to load usage.

01

Runs

Inspect job state and operation outcomes returned by the service.

Job inspection API
02

Evidence

Inspect the validated acquisition package for a successful fetch job.

Evidence package v1