{"openapi":"3.1.0","info":{"title":"IntentRoute ARD-compatible Discovery API","version":"0.2.0","description":"Pinned ARD v0.9 compatibility subset. See /catalog/v0.2/compatibility/ard-v0.9-profile.json."},"servers":[{"url":"https://intentroute.net/api/ard/v0.9"}],"paths":{"/search":{"post":{"operationId":"searchAgents","summary":"Deterministic relevance search","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"}}}},"/explore":{"post":{"operationId":"exploreRegistry","summary":"Faceted registry exploration","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExploreRequest"}}}},"responses":{"200":{"description":"Facet counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExploreResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"}}}},"/agents":{"get":{"operationId":"listAgents","summary":"Deterministic catalog listing","parameters":[{"name":"filter","in":"query","schema":{"type":"string","maxLength":1000}},{"name":"orderBy","in":"query","schema":{"type":"string"}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"pageToken","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Catalog entries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"This OpenAPI document","responses":{"200":{"description":"OpenAPI 3.1 document"}}}}},"components":{"schemas":{"QueryModel":{"type":"object","additionalProperties":false,"properties":{"@context":{"oneOf":[{"type":"string","format":"uri"},{"type":"object"},{"type":"array"}]},"text":{"type":"string","minLength":1,"maxLength":500},"filter":{"type":"object","maxProperties":12,"additionalProperties":{"oneOf":[{"type":"string"},{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string"}}]}}}},"SearchRequest":{"type":"object","required":["query"],"additionalProperties":false,"properties":{"query":{"allOf":[{"$ref":"#/components/schemas/QueryModel"},{"type":"object","required":["text"]}]},"federation":{"type":"string","enum":["none"],"default":"none"},"pageSize":{"type":"integer","minimum":1,"maximum":20,"default":10},"pageToken":{"type":"string"}}},"SearchResult":{"allOf":[{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","pattern":"^urn:air:"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object"},"intentroute":{"type":"object"}},"additionalProperties":true},{"type":"object","required":["score","source"],"properties":{"score":{"type":"integer","minimum":0,"maximum":100},"source":{"type":"string","format":"uri"}}}]},"SearchResponse":{"type":"object","required":["results"],"additionalProperties":false,"properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}},"pageToken":{"type":"string"}}},"ExploreRequest":{"type":"object","required":["resultType"],"additionalProperties":false,"properties":{"query":{"$ref":"#/components/schemas/QueryModel"},"resultType":{"type":"object","required":["facets"],"additionalProperties":false,"properties":{"facets":{"type":"array","minItems":1,"items":{"type":"object","required":["field"],"additionalProperties":false,"properties":{"field":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":20},"minCount":{"type":"integer","minimum":1}}}}}}}},"ExploreResponse":{"type":"object","required":["resultType","facets"],"additionalProperties":false,"properties":{"resultType":{"const":"facets"},"facets":{"type":"object"}}},"ListResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","pattern":"^urn:air:"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object"},"intentroute":{"type":"object"}},"additionalProperties":true}},"total":{"type":"integer"},"pageToken":{"type":"string"}}},"Error":{"type":"object","required":["errorCode","message"],"additionalProperties":false,"properties":{"errorCode":{"type":"string"},"message":{"type":"string"}}}},"responses":{"BadRequest":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"type":"object","required":["errorCode","message"],"additionalProperties":false,"properties":{"errorCode":{"type":"string"},"message":{"type":"string"}}}}}},"PayloadTooLarge":{"description":"Request body exceeds 8192 bytes","content":{"application/json":{"schema":{"type":"object","required":["errorCode","message"],"additionalProperties":false,"properties":{"errorCode":{"type":"string"},"message":{"type":"string"}}}}}},"UnsupportedMediaType":{"description":"application/json is required","content":{"application/json":{"schema":{"type":"object","required":["errorCode","message"],"additionalProperties":false,"properties":{"errorCode":{"type":"string"},"message":{"type":"string"}}}}}}}},"x-intentroute-profile":"ard-v0.9-intentroute-2026-08-24","x-intentroute-ranking":{"algorithm":"BM25F","commercialBoost":false,"personalization":false}}