{"uid":"cap_nVxQStstQYG_yWfo_C1bk","slug":"agentrag-ingest-44cfd801","name":"AgentRAG Ingest","description":"Explicit pre-warm for AgentRAG over x402 — index URLs, same-origin crawl roots, or raw documents (text with no URL) ahead of querying, or force a refresh of already-indexed pages. The only way to index raw text directly. Ingest $0.005/page; prepay $1 = 10,000 credits, spent at 80% of the per-op price (20% off). Docs: https://agentx402.ai","url":"https://api.agentx402.ai/v1/rag/ingest","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xWxuQ4sb5rGp-udW5-zkC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Pre-warms the AgentRAG retrieval index by ingesting URLs, crawl roots, or raw text documents ahead of querying, or forces a refresh of already-indexed pages.","exampleAgentPrompt":"Index https://docs.myproduct.com as a crawl root in AgentRAG so I can query it later — crawl the whole same-origin site and make sure it's fresh.","exampleUseCases":[{"title":"Pre-index product docs before querying","prompt":"Before I start asking questions, index https://docs.stripe.com into AgentRAG by crawling the whole site so my queries have up-to-date content to retrieve from."},{"title":"Ingest raw internal policy text","prompt":"I have a raw text document — our internal refund policy — with no URL. Can you ingest it directly into AgentRAG so I can query it later?"},{"title":"Force refresh stale indexed pages","prompt":"The pages I indexed last week from https://changelog.example.com are out of date — can you force a refresh on them in AgentRAG so I get the latest content?"}],"resultDescription":"Returns an ingestion confirmation indicating how many pages were indexed or refreshed, along with credit usage. Indexed content becomes available for retrieval via the AgentRAG query endpoint.","failureModes":["Invalid or unreachable URL returns an error with no credits charged","Raw text body missing or malformed causes a 400 validation error","Insufficient prepaid credits results in a payment-required or 402 response","Same-origin crawl exceeds page limit, partial ingestion returned","Network timeout on large crawl roots may result in partial completion"],"whenToPreferThis":"Use this endpoint when you need to pre-populate or refresh the AgentRAG index before issuing queries — especially for raw text documents that have no URL (the only way to index plain text), for bulk crawl-based ingestion of a site, or when you want to guarantee fresh content. Prefer this over the query endpoint's inline indexing when you want explicit control over what's indexed, when ingestion latency should be decoupled from query latency, or when you want to take advantage of the prepay credit discount (20% off per-op price).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:49:43.832Z","isFirstParty":false}