{"openapi":"3.1.0","info":{"title":"Agent Errors API","version":"1.0.0","summary":"Learn from the failures of other AI agents.","description":"Agent Errors is an evidence-based knowledge base of real AI-agent failures: what failed, the symptoms, the documented cause, every remediation that was tried (including the ones that failed), how success was verified, and whether the failure came back. Every claim is tied to a verbatim quote from a public source and labelled VERIFIED_FACT, SUPPORTED_INTERPRETATION, REPORTED_CLAIM, INFERENCE or UNKNOWN.\n\nPaid operations use x402 v2 (USDC on Base mainnet (eip155:8453), 0.018 USDC per lookup). Send the request once; on 402, sign the challenge from the PAYMENT-REQUIRED header and retry with PAYMENT-SIGNATURE.","contact":{"url":"https://agenterrors.online/docs"}},"servers":[{"url":"https://agenterrors.online"}],"paths":{"/api/v1/search":{"post":{"operationId":"searchFailures","summary":"Find documented agent failures similar to your symptoms","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload (base64)."}],"responses":{"200":{"description":"Matches (paid) or no_match (free).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required; body has a free preview and the x402 challenge.","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/cases":{"get":{"operationId":"listCases","summary":"Public summaries of every case (free)","responses":{"200":{"description":"Case summaries","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/cases/{case_id}":{"get":{"operationId":"getCase","summary":"Full evidence record of one case (paid; public samples free)","parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","pattern":"^AE-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{8}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Case record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseRecord"}}}},"402":{"description":"Payment required (body includes the public summary)"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/results/{result_id}":{"get":{"operationId":"getResult","summary":"Re-fetch a paid result (free, 24 h)","parameters":[{"name":"result_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The stored result"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/categories":{"get":{"operationId":"categories","summary":"Error taxonomy with published counts","responses":{"200":{"description":"Taxonomy"}}}},"/api/v1/stats":{"get":{"operationId":"stats","summary":"Aggregates computed from published records only","responses":{"200":{"description":"Statistics"}}}},"/api/v1/pricing":{"get":{"operationId":"pricing","summary":"Price, payment terms and cost breakdown","responses":{"200":{"description":"Pricing"}}}},"/api/v1/health":{"get":{"operationId":"health","summary":"Configuration health (no database); ?ready=1 adds a cached database probe","parameters":[{"name":"ready","in":"query","required":false,"schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"OK"},"503":{"description":"Fail-closed: payments unavailable"}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"SearchRequest":{"type":"object","additionalProperties":false,"description":"At least one of query, symptoms or error_message. Any language.","properties":{"query":{"type":"string","maxLength":2000},"symptoms":{"type":"array","items":{"type":"string","maxLength":300},"maxItems":12},"error_message":{"type":"string","maxLength":1000},"framework":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":40,"description":"Programming language of the agent."},"model":{"type":"string","maxLength":80},"environment":{"type":"string","maxLength":300},"recent_changes":{"type":"array","items":{"type":"string","maxLength":300},"maxItems":12},"category":{"type":"string","enum":["HALLUCINATION","TOOL_FAILURE","RETRY_LOOP","AUTHORITY_ERROR","PROMPT_INJECTION","MEMORY_FAILURE","PLANNING_FAILURE","REASONING_FAILURE","IDENTITY_FAILURE","PAYMENT_FAILURE","SECURITY_FAILURE","DATA_FAILURE","COST_FAILURE","CONCURRENCY_FAILURE","MULTILINGUAL_FAILURE","EVIDENCE_FAILURE","INTEGRATION_FAILURE","OTHER"]},"min_classification":{"type":"string","enum":["STRONG","POSSIBLE","WEAK"],"default":"WEAK"},"max_results":{"type":"integer","minimum":1,"maximum":10,"default":5}}},"SearchResult":{"type":"object","properties":{"no_match":{"type":"boolean"},"result_id":{"type":"string"},"query":{"type":"object","description":"Detected language, concepts (with your matched words), identifiers, frameworks."},"interpretation":{"type":"string"},"matches":{"type":"array","items":{"$ref":"#/components/schemas/Match"}},"differential":{"type":["object","null"]},"receipt":{"type":"object"}}},"Match":{"type":"object","properties":{"case_id":{"type":"string"},"similarity":{"type":"object","properties":{"classification":{"type":"string","enum":["STRONG","POSSIBLE","WEAK"]},"score":{"type":"number"},"reasons":{"type":"array","items":{"type":"string"}},"differences":{"type":"array","items":{"type":"string"}}}},"failure_pattern":{"type":"object"},"known_causes":{"type":"array","items":{"type":"object"}},"successful_repairs":{"type":"array","items":{"type":"object"}},"failed_repairs":{"type":"array","items":{"type":"object"}},"suggested_repairs":{"type":"array","items":{"type":"object"}},"verification_methods":{"type":"array","items":{"type":"string"}},"outcome":{"type":"object"},"recurrence":{"type":"object"},"evidence":{"type":"array","items":{"type":"object"}},"confidence":{"type":"object"},"sources":{"type":"array","items":{"type":"object"}},"freshness":{"type":"object"}}},"CaseRecord":{"type":"object","description":"Case schema v1; see https://agenterrors.online/docs#schema","properties":{"schema_version":{"type":"string"},"case_id":{"type":"string"},"case_type":{"type":"string","enum":["REAL_WORLD","CONTROLLED_TEST_CASE"]}}}}},"x-concepts":85}