{"openapi":"3.1.0","info":{"title":"ProofFlow Audit API","version":"0.3.0","description":"Source-cited Devpost submission-compliance audits powered by Gemini and persisted in Firestore.","x-guidance":"Use POST /api/v1/audits when an agent needs to compare public Devpost rules with a public GitHub repository and optional deployment. Send rulesUrl and repoUrl as HTTPS URLs, plus projectUrl when available. The paid response is a persisted evidence ledger with a readiness score, requirement statuses, cited evidence, risks, next actions, and report links. Use GET /api/v1/audits for free purchase instructions; it never creates or charges for an audit.","license":{"name":"Apache-2.0","identifier":"Apache-2.0"},"contact":{"name":"ArgonautWorks","url":"https://github.com/ArgonautWorks/proofflow-agent"}},"servers":[{"url":"https://proofflow-agent.vercel.app"}],"paths":{"/api/v1/audits":{"get":{"operationId":"describeProofFlowAuditPurchase","summary":"Return free purchase instructions for the paid audit operation","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Paid operation, price, settlement, schema, and discovery links"}}},"post":{"operationId":"createProofFlowAudit","summary":"Generate a persisted evidence audit for a public Devpost project","tags":["Compliance audits"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rulesUrl","repoUrl"],"properties":{"rulesUrl":{"type":"string","pattern":"^https://","description":"Official Devpost contest rules URL."},"repoUrl":{"type":"string","pattern":"^https://","description":"Public GitHub repository root URL."},"projectUrl":{"type":"string","pattern":"^https://","description":"Optional public Vercel or Devpost deployment URL."}},"additionalProperties":false},"example":{"rulesUrl":"https://allthingsagentichackathon.devpost.com/rules","repoUrl":"https://github.com/ArgonautWorks/proofflow-agent","projectUrl":"https://proofflow-agent.vercel.app"}}}},"responses":{"201":{"description":"Persisted JSON audit with requirement ledger and report route"},"400":{"description":"Invalid or unsupported public source; payment is not settled"},"402":{"description":"x402 Base-USDC payment challenge"},"429":{"description":"Daily paid capacity reached; payment is not settled"},"503":{"description":"Temporary upstream model failure; payment is not settled"}}}},"/a2a":{"post":{"operationId":"sendProofFlowDiscoveryA2aMessage","summary":"Return free purchase guidance without running an audit","tags":["Discovery"],"security":[],"responses":{"200":{"description":"A2A JSON-RPC discovery response"}}}}}}