API reference

Agent API

The public, pay-per-request surface. Machine-readable spec at /openapi.json. See the x402 walkthrough for the payment flow.

Endpoint	Summary	Notes
POST /agent/v1/search	Search an ephemeral private index	Semantic, cross-modal (text→image), or reverse-image search. $0.006 per call.
POST /agent/v1/ingest	Ingest a file ($0.03)	multipart/form-data upload into the payer's ephemeral index.
GET /agent/v1/items/{item_id}	Fetch item metadata ($0.002)