Agent Preflight
Pre-execution decision for a metered search or browse tool call. Evaluates the proposal; does not execute the external tool.
Offering
- Provider
- api.agent-preflight.com
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Api
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.agent-preflight.com/v0.2/preflight/tool-call- MIME type
- Not provided
- First seen
- 2026-10-16T01:50:24.663Z
- Last seen
- Tags
- None supplied
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "2000",
"payTo": "0x75ea953cf2c5dd8ebb304d50fb52a7d47c952a8a"
}
]Observed health
- Status
- Healthy
- Latest latency
- 146 ms
- Average latency
- 680 ms
- HTTP status
- 204
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"description": "Pre-execution tool-call decision input. This endpoint evaluates the proposed tool call and does not execute the external tool.",
"properties": {
"budget": {
"additionalProperties": false,
"properties": {
"maxToolCallsRemaining": {
"minimum": 0,
"type": "integer"
},
"remainingUsd": {
"minimum": 0,
"type": "number"
},
"reservedUsd": {
"minimum": 0,
"type": "number"
}
},
"required": [
"remainingUsd"
],
"type": "object"
},
"capabilities": {
"additionalProperties": false,
"properties": {
"canReduceScope": {
"type": "boolean"
},
"canReusePriorResult": {
"type": "boolean"
}
},
"type": "object"
},
"freshnessTtlSeconds": {
"description": "Explicit positive TTL required for reuse. Omitted or zero disables reuse.",
"maximum": 1000000000,
"minimum": 0,
"type": "number"
},
"history": {
"description": "At most 100 caller-owned prior outcomes; reuse requires explicit permission, positive freshness TTL and matching nonempty goal hashes.",
"items": {
"additionalProperties": false,
"properties": {
"ageSeconds": {
"minimum": 0,
"type": "number"
},
"fingerprint": {
"type": "string"
},
"goalHash": {
"type": "string"
},
"outcome": {
"enum": [
"success",
"terminal_failure",
"transient_failure"
],
"type": "string"
},
"resultReference": {
"type": "string"
},
"toolCallId": {
"type": "string"
}
},
"required": [
"toolCallId",
"fingerprint",
"outcome",
"ageSeconds"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"preflightPriceUsd": {
"default": 0.002,
"description": "Modeled actionable fee only; cannot change the actual HTTP settlement price.",
"minimum": 0,
"type": "number"
},
"retryCap": {
"default": 1,
"minimum": 1,
"type": "integer"
},
"runId": {
"description": "Caller-scoped run identifier",
"minLength": 1,
"type": "string"
},
"stepId": {
"description": "Caller-scoped step identifier within the run",
"minLength": 1,
"type": "string"
},
"task": {
"additionalProperties": false,
"properties": {
"goalHash": {
"description": "Opaque goal correlation token",
"type": "string"
}
},
"required": [
"goalHash"
],
"type": "object"
},
"tool": {
"additionalProperties": false,
"properties": {
"estimatedExternalCostUsd": {
"description": "Estimated USD cost of the external tool call",
"minimum": 0,
"type": "number"
},
"estimatedModelCostUsd": {
"description": "Optional estimated USD model cost for this step",
"minimum": 0,
"type": "number"
},
"operation": {
"description": "Tool operation. Supported: search:web_search, browse:fetch",
"minLength": 1,
"type": "string"
},
"provider": {
"description": "Tool provider. Supported: search, browse",
"minLength": 1,
"type": "string"
},
"request": {
"additionalProperties": true,
"description": "Provider-specific payload. search/web_search requires query (string 1..500) and optional max_results (1..10). browse/fetch requires url (http/https).",
"properties": {
"max_results": {
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"query": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"url": {
"minLength": 1,
"type": "string"
}
},
"type": "object"
}
},
"required": [
"provider",
"operation",
"request",
"estimatedExternalCostUsd"
],
"type": "object"
}
},
"required": [
"runId",
"stepId",
"tool",
"budget"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}Output schema
{
"properties": {
"example": {
"additionalProperties": false,
"description": "Deterministic pre-execution decision. The destination tool is never executed by this service.",
"properties": {
"decision": {
"enum": [
"allow",
"block",
"reuse",
"defer",
"advise"
],
"type": "string"
},
"enforcement": {
"enum": [
"execute",
"safe_to_skip",
"advisory"
],
"type": "string"
},
"estimated": {
"additionalProperties": false,
"properties": {
"avoidableExternalCostUsd": {
"type": "number"
},
"avoidableModelCostUsd": {
"type": "number"
},
"billable": {
"type": "boolean"
},
"confidence": {
"description": "Rule constant, not a calibrated probability.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"netSavingsUsd": {
"type": "number"
},
"preflightCostUsd": {
"type": "number"
},
"priceChargedUsd": {
"description": "Legacy modeled actionable fee, NOT an actual settlement receipt. Paid allow/advise responses can show zero here.",
"type": "number"
}
},
"required": [
"preflightCostUsd",
"priceChargedUsd",
"avoidableExternalCostUsd",
"avoidableModelCostUsd",
"netSavingsUsd",
"billable",
"confidence"
],
"type": "object"
},
"issues": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"path": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"type": "object"
},
"type": "array"
},
"matchedCallId": {
"type": "string"
},
"reasonCodes": {
"items": {
"type": "string"
},
"type": "array"
},
"recommendation": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"resultReference": {
"type": "string"
}
},
"type": "object"
},
"requestFingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"decision",
"enforcement",
"reasonCodes",
"requestFingerprint",
"issues",
"estimated"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}