API या AI सहायक से बोर्ड संचालित करें

बोर्ड्स को डैशबोर्ड के बाहर से पूरी तरह से संचालित किया जा सकता है। दो रूट्स, एक अनुमति मॉडल, और स्क्रीन जैसा ही व्यवहार — क्योंकि वे एक ही कोड को कॉल करते हैं।

REST API

प्रत्येक ऑपरेशन हमारे सार्वजनिक OpenAPI विनिर्देश में है, जिसमें TypeScript, Python, PHP और Go में जनरेट किए गए क्लाइंट शामिल हैं, और CLI भी उसी विनिर्देश से जनरेट किया गया है। बोर्ड्स, कॉलम, कार्ड्स, टिप्पणियाँ, प्रश्न, लेबल्स, सदस्य और शेयर लिंक सभी इसमें शामिल हैं।

वे एंडपॉइंट्स जिनका आप सबसे अधिक उपयोग करेंगे:

• GET /v1/agency/boards — आपके बोर्ड्स
• GET /v1/agency/boards/{id} — अपने कॉलम और कार्ड्स के साथ एक बोर्ड
• POST /v1/agency/boards/{id}/cards — कार्य जोड़ें
• POST /v1/agency/boards/{id}/cards/{id}/move — इसे स्थानांतरित करें
• POST /v1/agency/boards/{id}/invites — एक शेयर लिंक बनाएं

शेयर लिंक का टोकन उस अंतिम कॉल पर और केवल उसी कॉल पर वापस आता है। हम इसका एक फ़िंगरप्रिंट संग्रहीत करते हैं, इसलिए ऐसा कोई एंडपॉइंट नहीं है जो इसे वापस पढ़ सके — यदि आपकी स्क्रिप्ट को लिंक की आवश्यकता है, तो इसे प्रतिक्रिया से सहेज कर रखें।

MCP सर्वर

यदि आप ऐसे AI सहायक का उपयोग करते हैं जो MCP का समर्थन करता है, तो इसे कनेक्ट करें और इसे सीधे बोर्ड टूल्स मिल जाते हैं: बोर्ड्स सूचीबद्ध करना, किसी एक को पूरा पढ़ना, बोर्ड बनाना, कार्ड जोड़ना, कार्ड स्थानांतरित करना, टिप्पणी करना, शेयर लिंक बनाना और उसे निरस्त करना। यह "इस सप्ताह का सारांश बनाएं और Acme को एक लिंक भेजें" को दो प्रणालियों और कॉपी-पेस्ट के बजाय एक निर्देश में बदल देता है।

टूल्स के बारे में जानने योग्य दो बातें:

• एक नया कार्ड आंतरिक होता है जब तक कि आप अन्यथा न कहें। आपके आंतरिक कार्य का सारांश तैयार करने वाले सहायक को वह सारांश आपके क्लाइंट को केवल इसलिए प्रकाशित नहीं करना चाहिए क्योंकि किसी ने मना नहीं किया था, इसलिए visibility डिफ़ॉल्ट रूप से आंतरिक होती है और इसे जानबूझकर client पर सेट करना पड़ता है।
• लिंक निरस्त करने के लिए पुष्टि मांगी जाती है, क्योंकि यह उस लिंक के माध्यम से शामिल हुए किसी भी व्यक्ति को भी हटा देता है — और टूल केवल एक सामान्य सफलता की रिपोर्ट करने के बजाय आपको बताता है कि कितने लोग प्रभावित हुए।

इसके लिए क्या आवश्यक है

API और MCP एक्सेस Boards Business में और प्रत्येक Agency होस्टिंग प्लान में शामिल है। Boards Free और Boards Pro पर बोर्ड एंडपॉइंट्स ऐसा बताते हुए एक संदेश के साथ उत्तर देते हैं।

एक API कुंजी या MCP कनेक्शन केवल वही कर सकता है जो इसे बनाने वाला व्यक्ति कर सकता है, उन संगठनों में जिनमें वे ऐसा कर सकते हैं। सहायक द्वारा बनाया गया शेयर लिंक भी उसी तरह से सीमित होता है: यह ऐसी कोई भूमिका प्रदान नहीं कर सकता जो अधिकृत करने वाले व्यक्ति के पास स्वयं न हो।