{"openapi":"3.1.0","info":{"title":"Render AI Discovery API","version":"1.0.0","description":"Machine-readable discovery endpoints for Render documentation and AI-facing platform metadata."},"servers":[{"url":"https://render.com"}],"paths":{"/api/agent/docs-search":{"get":{"operationId":"searchRenderDocs","summary":"Search Render docs","description":"Returns machine-readable Render docs search results.","parameters":[{"name":"query","in":"query","required":true,"description":"Keywords to search for in the Render docs.","schema":{"type":"string"}}],"responses":{"200":{"description":"Search results.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/DocsSearchResult"}}},"required":["query","results"]}}}},"400":{"description":"Missing or invalid query."}}}},"/api/status":{"get":{"operationId":"getApiStatus","summary":"Fetch API health status","description":"Returns a machine-readable health response for the public discovery API.","responses":{"200":{"description":"Health response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiStatus"}}}}}}},"/docs/{slug}.md":{"get":{"operationId":"getDocsPageMarkdown","summary":"Fetch a docs page as markdown","parameters":[{"name":"slug","in":"path","required":true,"description":"Docs page slug.","schema":{"type":"string"}}],"responses":{"200":{"description":"Markdown response for the requested docs page.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsIndex","summary":"Fetch the Render llms.txt index","responses":{"200":{"description":"LLMs index in markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/llms-full.txt":{"get":{"operationId":"getLlmsFull","summary":"Fetch the full Render docs corpus for LLMs","responses":{"200":{"description":"Expanded documentation corpus in markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/blog.md":{"get":{"operationId":"getBlogMarkdownIndex","summary":"Fetch recent Render blog links as markdown","responses":{"200":{"description":"Markdown index for the 20 most recent blog posts.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/articles.md":{"get":{"operationId":"getArticlesMarkdownIndex","summary":"Fetch recent Render article links as markdown","responses":{"200":{"description":"Markdown index for the 50 most recent articles.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/.well-known/mcp.json":{"get":{"operationId":"getMcpDiscovery","summary":"Fetch Render MCP discovery metadata","description":"Returns discovery metadata for the hosted Render MCP server, including structured authentication details and where to find its server card.","responses":{"200":{"description":"MCP discovery document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp/server-card.json":{"get":{"operationId":"getMcpServerCard","summary":"Fetch the Render MCP Server Card","description":"Returns the MCP Server Card for the hosted Render MCP server, including authentication requirements.","responses":{"200":{"description":"MCP Server Card.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/webmcp.json":{"get":{"operationId":"getWebMcpManifest","summary":"Fetch Render WebMCP manifest","responses":{"200":{"description":"WebMCP manifest.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/agents.json":{"get":{"operationId":"getAgentsDirectory","summary":"Fetch the Render agent directory","responses":{"200":{"description":"Agent directory.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/agent-skills/index.json":{"get":{"operationId":"getAgentSkillsDiscoveryIndex","summary":"Fetch the Render Agent Skills discovery index","responses":{"200":{"description":"Agent Skills discovery index.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/api-catalog":{"get":{"operationId":"getApiCatalog","summary":"Fetch the Render API catalog","responses":{"200":{"description":"API catalog in Linkset format.","content":{"application/linkset+json":{"schema":{"type":"object"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApiSpec","summary":"Fetch this OpenAPI document","responses":{"200":{"description":"OpenAPI 3.1 specification.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"ApiStatus":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"service":{"type":"string"}},"required":["status","service"]},"DocsSearchResult":{"type":"object","properties":{"title":{"type":"string"},"excerpt":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"category":{"type":"string","enum":["docs"]}},"required":["title","excerpt","slug","url","category"]}}}}