{"openapi":"3.1.0","info":{"title":"Tirtle public information concierge","version":"1.0.0","description":"Read authored public documentation. No learner data or state-changing operations. The sandbox additionally requires invited tester access through its existing sign-in."},"servers":[{"url":"https://tirtle.com"}],"paths":{"/api/agent/concierge":{"get":{"operationId":"findTirtlePublicInformation","summary":"List public resources, search guides, or read one resource","description":"Omit parameters for the catalog. Choose q for search, or resource for one Markdown document. q and resource are mutually exclusive. limit requires q. Duplicate or unknown parameters are rejected.","parameters":[{"name":"q","in":"query","schema":{"type":"string","minLength":1,"maxLength":200},"description":"Public information search terms."},{"name":"resource","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]{1,100}$"},"description":"Resource id from the catalog."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10,"default":5},"description":"Maximum search results, only with q."}],"responses":{"200":{"description":"Catalog, search results, or one public document.","content":{"application/json":{"schema":{"type":"object","required":["name","scope","operation","directory"],"properties":{"name":{"type":"string"},"scope":{"const":"read-only-public-documentation"},"operation":{"enum":["catalog","search","resource"]},"directory":{"type":"string","format":"uri"},"resources":{"type":"array","items":{"type":"object","required":["id","title","url","markdownUrl","requiresAccount"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"url":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"requiresAccount":{"type":"boolean"}}}},"resource":{"type":"object","description":"Selected resource metadata and Markdown content."},"message":{"type":"string"}}}}}},"400":{"description":"Invalid or conflicting parameters."},"403":{"description":"Sandbox tester access required."},"404":{"description":"Unknown public resource."},"405":{"description":"This endpoint accepts GET and HEAD only."}}}}}}