{"openapi":"3.1.0","info":{"title":"Intent classification review","version":"1.0.0","description":"Classify text with a bounded keyword heuristic for human review. Does not execute a model, select a verified cheapest model or prove routing savings."},"servers":[{"url":"https://agents.getardaro.com"}],"paths":{"/v1/agent-utilities/intent-routing/analyze":{"post":{"operationId":"route_model_intent","summary":"Classify text with a bounded keyword heuristic for human review. Does not execute a model, select a verified cheapest model or prove routing savings.","x-price-usdc":"0.15","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intent_payload":{"type":"string","minLength":1,"maxLength":32768,"description":"Caller-supplied text; do not submit secrets or private tenant data."}},"required":["intent_payload"],"additionalProperties":false}}}},"responses":{"200":{"description":"Settled advisory analysis; human review required.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contract_version","service_id","status","result","identities"],"properties":{"contract_version":{"const":"ardaro.agent-utilities.response.v1"},"service_id":{"const":"ardaro.route_model_intent"},"status":{"const":"review_required"},"result":{"type":"object","properties":{"status":{"type":"string","const":"ADVISORY_ROUTE"},"route_category":{"type":"string","enum":["structured-calculation-review","general-text-review"]},"routing_basis":{"type":"string","const":"Keyword heuristic only; no model capability, availability or price comparison"},"recommended_model":{"type":"null"},"route_executed":{"type":"boolean","const":false},"human_review_required":{"type":"boolean","const":true}},"required":["status","route_category","routing_basis","recommended_model","route_executed","human_review_required"],"additionalProperties":false},"identities":{"type":"object","additionalProperties":false,"required":["analysis_result_identity","payment_identity"],"properties":{"analysis_result_identity":{"type":"string","pattern":"^res_[0-9a-f]{64}(?![\\s\\S])"},"payment_identity":{"type":"object","additionalProperties":false,"required":["protocol","reference","replayed"],"properties":{"protocol":{"const":"x402-v2"},"reference":{"type":"string","pattern":"^pay_[0-9a-f]{64}(?![\\s\\S])"},"replayed":{"type":"boolean"}}}}}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64 x402 settlement receipt; validate exact route, currency, amount and payee.","schema":{"type":"string"}}}},"402":{"description":"Payment required; no analysis result returned.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","contentEncoding":"base64"}}}},"400":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"409":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"413":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"415":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"503":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"504":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."}}}},"/v1/agent-utilities/intent-routing/status":{"get":{"responses":{"200":{"description":"Free cached readiness and terms."}}}},"/v1/agent-utilities/intent-routing/example":{"get":{"responses":{"200":{"description":"Fixed free synthetic input and result."}}}}}}