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 کنکشن صرف وہی کر سکتا ہے جو اسے بنانے والا شخص ان تنظیموں میں کر سکتا ہے جہاں وہ یہ کر سکتا ہے۔ اسسٹنٹ کی طرف سے بنایا گیا شیئر لنک بھی اسی طرح محدود ہے: یہ ایسا کوئی رول نہیں دے سکتا جو مجاز انسان خود نہ رکھتا ہو۔