search

Generate a grounded answer with citations

Ask a natural-language question about the registry and get a grounded answer with citations. POST a JSON body { question }; the answer carries inline [n] markers resolved by citations, each naming the surface it came from, so every claim is traceable to a registered surface rather than to the model. Use this when the question is exploratory ("which subnets expose a public inference API?"); use /api/v1/search/semantic when you want the ranked matches themselves rather than prose. Mirrored by the ask MCP tool. Served live (no static file); 503 ai_unavailable where no AI binding is configured.

post/api/v1/ask

Request

  • Base URL: https://api.metagraph.sh
  • URL: https://api.metagraph.sh/api/v1/ask
  • Auth: none required

Request body

questionstring required

The question to answer, in plain language. Exploratory questions work best ("which subnets expose a public inference API?"); for ranked matches rather than prose, use GET /api/v1/search/semantic.

Response

Canonical artifact wrapped in the Metagraphed API envelope.

oktrue required
schema_version1 required

Changes

No recorded changes to this operation across all 1 revision of this API.