Asana प्रोजेक्ट की सूची /asana/v1/connections/{connection_id}/projects पर एक GET है, जो Top-Rated Team Asana API में आता है: आपके संगठन के जोड़े हुए Asana अकाउंट, और वे प्रोजेक्ट जिन तक वे पहुँचते हैं। हर रिक्वेस्ट आपकी अपनी key को X-API-KEY हेडर में लेकर चलती है — वही key जो LinkedIn API की है — और सिर्फ़ उन्हीं कनेक्शनों तक पहुँचती है।
कॉल उस टोकन से जाती हैं जो किसी सदस्य ने चिपकाया है, इसलिए Asana सब कुछ उसी व्यक्ति के नाम से दर्ज करता है — और प्रोजेक्ट रूम अपने टास्क को इसी कनेक्शन से तालमेल में रखता है।
रिक्वेस्ट
curl -X GET "https://top-rated.team/asana/v1/connections/$CONNECTION_ID/projects" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
पाथ में क्या जाता है
- connection_id — इसी परिवार की किसी पिछली कॉल से लौटी हुई id।
न चलने पर क्या लौटता है
- 401 — key नहीं है, ग़लत है या रद्द कर दी गई है।
- 402 — प्लान का भुगतान नहीं हुआ। ट्रायल ख़त्म होने पर Top-Rated Team API योजना यही लौटाती है।
- 404 — या तो वह चीज़ है ही नहीं, या वह आपके संगठन की नहीं है। दोनों का जवाब जान-बूझकर एक ही है, ताकि id टटोली न जा सकें।
- 429 — बहुत ज़्यादा रिक्वेस्ट, या प्लेटफ़ॉर्म हमसे धीमे चलने को कह रहा है। दोबारा कोशिश करने से पहले थोड़ा इंतज़ार कीजिए।
- 502 या 503 — प्लेटफ़ॉर्म ने अभी जवाब नहीं दिया। थोड़ी देर में फिर कोशिश कीजिए।
हर एरर एक ही शक्ल का JSON है: {"type":"errors/<code>","status":<n>,"detail":"..."} — इसलिए एक ही हैंडलर सब संभाल लेता है, और detail इसी तरह लिखा गया है कि किसी इंसान को दिखाया जा सके।
इसके बजाय असिस्टेंट से कहिए
यह ऑपरेशन एक MCP टूल भी है। https://top-rated.team/asana/mcp/<your API key> को Claude, ChatGPT या किसी भी MCP बोलने वाले असिस्टेंट में चिपकाइए और आम भाषा में जो चाहिए वह माँगिए — असिस्टेंट ख़ुद कॉल चुनेगा, id भरेगा और जवाब पढ़कर सुनाएगा। https://top-rated.team/mcp/<your API key> वाले ऑल-इन-वन एजेंट के पास भी यह है, LinkedIn API और बाकी हर चैनल के साथ।
प्रोजेक्ट रूम में
प्रोजेक्ट रूम में अपने किसी AI एजेंट के लिए “इस्तेमाल कर सकता है” के नीचे इस API के एजेंट पर टिक कीजिए, और जब भी बातचीत को ज़रूरत हो, वह “Asana प्रोजेक्ट की सूची” को टूल की तरह कॉल करता है। रूम में हर कोई देखता है कि उसने क्या माँगा और क्या लौटा। आम भाषा में कहिए; यहाँ एजेंट का नाम @scout है:
- @scout हमारे Asana लॉन्च प्रोजेक्ट में जो अभी खुला है वह दिखाइए, और प्राइसिंग पेज के लिए एक टास्क जोड़िए।
अक्सर पूछे जाने वाले सवाल
क्या कोई AI एजेंट मेरे लिए “Asana प्रोजेक्ट की सूची” कॉल कर सकता है?
हाँ। MCP बोलने वाला कोई भी असिस्टेंट ऊपर के पते के ज़रिए कर सकता है, और प्रोजेक्ट रूम में इस API के एजेंट पर टिक वाला आपका अपना AI एजेंट भी। रूम के बिल्ट-इन एजेंट नहीं कर सकते: वे सलाह देते हैं, और उनके पास आपकी key नहीं होती।
क्या यह रूम के बाहर, मेरे अपने कोड से चलता है?
हाँ। ऊपर की रिक्वेस्ट वही ऑपरेशन है जिसे AI एजेंट के टूल कॉल करते हैं, उसी जवाब और उन्हीं एरर के साथ, और आप जिस रास्ते से भी आएँ, आपकी key उन्हीं चैनलों तक पहुँचती है।
क्या यह मेरे अपने ब्रांड वाले रूम में चलता है?
हाँ। व्हाइट-लेबल पते पर API, उसकी संदर्भिका और उसका AI एजेंट आपके प्रोडक्ट के नाम से चलते हैं, और उन्हीं नियमों के तहत उन्हीं चैनलों तक पहुँचते हैं।
किस प्लान में है
Top-Rated Team API प्लान में शामिल, LinkedIn API वाली उसी key के साथ: $9 प्रति सीट प्रति माह, सौ सीट से $7। आपको उतनी सीट चाहिए जितनी इनमें से जिसकी संख्या सबसे ज़्यादा हो — LinkedIn अकाउंट, WhatsApp नंबर, X अकाउंट या इनबॉक्स अकाउंट — और 30 दिन का ट्रायल एक सीट को कवर करता है।