在一個地方找到所有 agent 與 API contract。
Use the human-readable guides for integration decisions and the machine-readable files for discovery, typed calls, authentication, and recovery.
REST API 與 agent 文件。
control API 用來佈建及管理專案；edge API 則使用已佈建的服務。請從 installer 開始，不要手動呼叫 tenant creation；將 project credentials 保留在伺服器端，並在進行 edge calls 前先閱讀所選的 offering page。
- Documentation index
Start here for onboarding, lifecycle, pricing, and links to every machine-readable surface.
GET https://cohesivity.ai/docs - OpenAPI 3.1 description
Typed discovery for bootstrap and common control-plane operations, including errors and response headers.
GET https://cohesivity.ai/openapi.json - Authentication guide
Tenant keys, wait tokens, public MCP access with optional account OAuth, PKCE, and credential boundaries.
GET https://cohesivity.ai/auth.md - Agent instructions
When to use cohesivity, how an agent should set up a project, and where each offering contract lives.
GET https://cohesivity.ai/llms.txt - Offering references
Endpoints, prerequisites, tier behavior, current limits, and common mistakes for every public service.
GET https://cohesivity.ai/offerings
模型上下文協定。
匿名文件伺服器與受 OAuth 保護的管理伺服器刻意分開。前者用來取得公開參考資料；後者只公開固定 allowlist 中的帳號與 tenant 工具，每次 tenant 呼叫都會重新檢查擁有權，而且不會傳回 tenant keys、provider secrets、environment values 或原始 wait capabilities。
- MCP discovery metadata
Use cohesivity’s vendor-defined alias to discover the one public server for documentation and management, its optional account OAuth, and its Streamable HTTP transport.
GET https://cohesivity.ai/.well-known/mcp.jsonPOST https://cohesivity.ai/mcp - MCP OAuth protected resource metadata
Discover the authorization server for optional account sign-in on the same MCP server.
GET https://cohesivity.ai/.well-known/oauth-protected-resource/mcp
版本管理與復原。
REST 回應會標示目前的 API 主版本，tenant 狀態會標示固定的 runtime profile，棄用項目則透過公開的回應 header 與遷移文件說明。如果公開頁面的 URL 不存在，其 404 會將 agent 引導回 sitemap、llms.txt、docs 索引與這份開發者索引。未知的 API 路由仍維持結構化 JSON 錯誤 contract。