Preview a signal set version | Runtype Documentation

Dry-run one version over an agent’s recent traces: per-signal fire rates, confidences, spans and projected monthly cost. Writes no results; the model calls are billed.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

versionNumberintegerRequired>=1

Request

This endpoint expects an object.

agentIdstringRequired

Run the version over this agent’s most recent completed traces.

acknowledgeExternalProcessingbooleanOptional

Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI, after a human confirms.

limitintegerOptional1-50

Traces to read, default 20, at most 50.

Response

Preview

costUsddouble

What this preview spent.

evaluatedinteger

failedinteger

labelAgreementany

Agreement with human labels; null until labels exist.

monthlyTraceVolumeinteger

noteslist of strings

projectedMonthlyUsddouble

Mean unit cost times the agent’s last-30-day trace volume.

sampleslist of maps from strings to any

signalslist of objects

tracesReadinteger

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error