{"openapi":"3.0.3","info":{"title":"Decixa Agent Hub API","description":"A curated, agent-optimized directory of APIs. AI agents can discover, evaluate, and integrate APIs using these endpoints.","version":"1.0.0","contact":{"url":"https://api.decixa.ai/for-ai-agents"}},"servers":[{"url":"https://api.decixa.ai","description":"Production"}],"paths":{"/.well-known/agent-index.json":{"get":{"summary":"Agent manifest","description":"Machine-readable manifest. Returns Decixa metadata including discover/detail endpoint URLs, pagination limits, and available filters.","operationId":"getAgentManifest","tags":["Discovery"],"responses":{"200":{"description":"Manifest object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentManifest"}}}}}}},"/api/agent/discover":{"get":{"summary":"Discover APIs","description":"Returns a paginated list of approved APIs matching the given filters. Default limit: 20, max: 50.","operationId":"discoverApis","tags":["Discovery"],"parameters":[{"name":"task","in":"query","description":"Free-text task description. Searches name and description.","schema":{"type":"string","example":"scrape reddit"}},{"name":"capability","in":"query","description":"Capability verb. One of the 9 Decixa capabilities.","schema":{"type":"string","enum":["Search","Extract","Transform","Analyze","Generate","Modify","Communicate","Transact","Store"],"example":"Extract"}},{"name":"tag","in":"query","description":"Capability tag for fine-grained filtering (e.g. Social Media, Risk Score).","schema":{"type":"string","example":"Social Media"}},{"name":"agent_ready","in":"query","description":"Filter to APIs that are ready for autonomous agent use.","schema":{"type":"string","enum":["true"]}},{"name":"latency_tier","in":"query","description":"Response latency tier.","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"execution_mode","in":"query","description":"Whether the API executes synchronously or asynchronously.","schema":{"type":"string","enum":["sync","async"]}},{"name":"pricing_model","in":"query","description":"Pricing structure.","schema":{"type":"string","enum":["per_call","subscription","hybrid"]}},{"name":"budget","in":"query","description":"Maximum price per call in USDC.","schema":{"type":"number","example":0.01}},{"name":"sort","in":"query","description":"Sort order.","schema":{"type":"string","enum":["trust","calls","price_asc","price_desc"],"default":"trust"}},{"name":"limit","in":"query","description":"Number of results to return (max 50).","schema":{"type":"integer","default":20,"maximum":50}},{"name":"offset","in":"query","description":"Offset for pagination.","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Paginated API list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoverResponse"}}}},"503":{"description":"Service unavailable"}}}},"/api/agent/detail/{id}":{"get":{"summary":"Get API detail","description":"Returns full metadata for a single API by ID.","operationId":"getApiDetail","tags":["Detail"],"parameters":[{"name":"id","in":"path","required":true,"description":"API UUID","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"API detail object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDetail"}}}},"404":{"description":"Not found"},"410":{"description":"API is no longer available (is_dead)"},"503":{"description":"Service unavailable"}}}}},"components":{"schemas":{"AgentManifest":{"type":"object","properties":{"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"discover_endpoint":{"type":"string"},"detail_endpoint":{"type":"string"},"total_apis":{"type":"integer"},"pagination":{"type":"object","properties":{"default_limit":{"type":"integer"},"max_limit":{"type":"integer"},"style":{"type":"string"}}},"filters":{"type":"array","items":{"type":"string"}},"pricing":{"type":"object","properties":{"access":{"type":"string"},"note":{"type":"string"}}}}},"ApiSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"endpoint":{"type":"string"},"pricing":{"type":"object","properties":{"model":{"type":"string"},"usdc_per_call":{"type":"number","nullable":true}}},"capability":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"agent_ready":{"type":"boolean"},"latency_tier":{"type":"string","nullable":true},"execution_mode":{"type":"string","nullable":true},"input_type":{"type":"array","items":{"type":"string"}},"output_type":{"type":"array","items":{"type":"string"}},"trust_score":{"type":"integer"},"detail_url":{"type":"string"}}},"DiscoverResponse":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next":{"type":"string","nullable":true},"prev":{"type":"string","nullable":true},"apis":{"type":"array","items":{"$ref":"#/components/schemas/ApiSummary"}}}},"ApiDetail":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"endpoint":{"type":"string"},"pricing":{"type":"object","properties":{"model":{"type":"string"},"usdc_per_call":{"type":"number","nullable":true}}},"capability":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"agent_compatibility":{"type":"object","properties":{"agent_ready":{"type":"boolean"},"latency_tier":{"type":"string","nullable":true},"execution_mode":{"type":"string","nullable":true},"data_mode":{"type":"string","nullable":true},"deterministic":{"type":"boolean","nullable":true}}},"schema":{"type":"object","properties":{"input_type":{"type":"array","items":{"type":"string"}},"output_type":{"type":"array","items":{"type":"string"}},"spec_url":{"type":"string","nullable":true}}},"use_cases":{"type":"array","items":{"type":"string"}},"trust_score":{"type":"integer"},"provider":{"nullable":true,"type":"object","properties":{"name":{"type":"string"},"website":{"type":"string","nullable":true}}},"decixa_url":{"type":"string"}}}}}}