Discovery

Discover capabilities

Find ranked capabilities from a natural-language query. Discover is free. Results include verification evidence and execution restrictions; clients must not treat any status other than verified as verified. Results may include expected_cost and billing_rule so clients can estimate a later Call.

post/search

Request

  • Base URL: https://qveris.ai/api/v1
  • URL: https://qveris.ai/api/v1/search
  • Auth: HTTP bearer

Request body

querystring required

Natural-language capability query or an exact tool ID for deterministic lookup.

limitinteger

Maximum number of ranked results to return.

session_idstring

Optional tracking and pricing-context identifier. It does not promise a cache hit.

view'routing' | 'full'

Response projection. routing returns compact routing cards (tool_id, capability, cost_class, reliability, as_of_support) plus the required verification and restriction contract; full or omitted returns the complete result shape.

lang'zh' | 'en'

Response language. When omitted the service negotiates from the Accept-Language header.

Response

Successful Response

querystring required
search_idstring required
totalinteger required
elapsed_time_msnumber
remaining_creditsnumber nullable
error_messagestring nullable
contract_warningsstring[]
contract_featuresstring[]

Changes

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