API referansı İngilizce yayımlanır.
Create a tool connection
/api/companies/{companyId}/tools/connectionsCreate a tool connection.
Saves a connection as given without checking that its server answers. To connect an MCP server from its URL, use POST /api/companies/{companyId}/tools/apps/connect with link instead: it checks the server first, and a fresh setup saves no connection when the server cannot be reached. When a person's own MCP server needs an API key, the person adds it themselves on Connect your own MCP server: they enter its URL and type the key into that page's secure field. An agent cannot enter the key and must not ask for it in chat. Link that page and reply instead of creating the connection here.
Yetkilendirme
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. Anahtarlar nasıl çalışır.
Yol parametreleri
İstek gövdesi
application/json · zorunlu
1–2000 characters1–160 characters> 01–160 characters1–160 charactersone of: "tool", "channel"one of: "mcp_remote", "rest_api", "local_stdio", "chat_sdk", "voice"one of: "oauth", "api_key", "none"one of: "shared", "per_user", "per_user_with_fallback", "per_agent"one of: "platform_shared", "platform_provisioned", "customer", "dcr"one of: "draft", "active", "disabled", "archived"one of: "managed"1–120 charactersone of: "header", "env", "url"1–160 charactersat most 120 characters1–200 charactersat most 120 charactersone of: "unclassified", "class_3_static_lease"1–160 characters1–160 charactersYanıtlar
details names each field that failed.Hatalar {"error": "..."} döndürür, çoğu zaman bir code ve details ile birlikte. Ayrıntılar için: hatalar ve limitler.