Examples

Requests using only fields supported by Veyrly v0.1.

Example request

curl -X POST https://api.veyrly.com/v1/evidence \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_KEY" \
  -d '{
    "query": "What is the purpose of robots.txt?",
    "max_sources": 5
  }'

Example response (shortened)

{
  "status": "fulfilled",
  "query": "What is the purpose of robots.txt?",
  "answer": "The Robots Exclusion Protocol lets site owners communicate crawler access preferences.",
  "sources": [
    {
      "title": "RFC 9309: Robots Exclusion Protocol",
      "url": "https://www.rfc-editor.org/rfc/rfc9309.html",
      "snippet": "This document specifies the Robots Exclusion Protocol.",
      "published_at": "2022-09-01T00:00:00Z",
      "updated_at": null
    }
  ],
  "freshness": { "required": false, "satisfied": true, "newest_timestamp": null },
  "evidence": { "source_count": 5, "distinct_source_count": 4, "validated": true },
  "fulfilled_at": "2026-09-01T21:11:48.428Z",
  "request_id": "78390ac9-ff82-459e-a7f0-2ee63ce2553c"
}

Fresh evidence

{
  "query": "What changed in the Base documentation this week?",
  "freshness_seconds": 604800,
  "max_sources": 5
}

Evergreen research

{
  "query": "Explain the purpose of the Robots Exclusion Protocol.",
  "max_sources": 5
}