بورڈز ڈیش بورڈ کے باہر سے بھی مکمل طور پر چلائے جا سکتے ہیں۔ دو راستے، ایک اجازت کا ماڈل، اور اسکرینوں جیسا ہی طرزِ عمل — کیونکہ وہ اسی کوڈ کو کال کرتے ہیں۔
The 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 — ایک شیئر لنک بنائیں
شیئر لنک کا ٹوکن اس آخری کال پر واپس آتا ہے اور صرف اسی کال پر۔ ہم اس کا فنگر پرنٹ محفوظ کرتے ہیں، لہٰذا کوئی ایسا اینڈ پوائنٹ نہیں ہے جو اسے دوبارہ پڑھ سکے — اگر آپ کے اسکرپٹ کو لنک کی ضرورت ہے، تو اسے جواب سے ہی محفوظ رکھیں۔
The MCP server
اگر آپ ایسا AI اسسٹنٹ استعمال کرتے ہیں جو MCP کو سپورٹ کرتا ہے، تو اسے مربوط کریں اور یہ بورڈ ٹولز تک براہ راست رسائی حاصل کر لیتا ہے: بورڈز کی فہرست بنانا، کسی ایک کو مکمل طور پر پڑھنا، بورڈ بنانا، کارڈ شامل کرنا، کارڈ منتقل کرنا، تبصرہ کرنا، شیئر لنک بنانا اور اسے منسوخ کرنا۔ یہ "اس ہفتے کا خلاصہ کریں اور Acme کو ایک لنک بھیجیں" کو دو سسٹمز اور کاپی پیسٹ کے بجائے ایک ہی ہدایت میں تبدیل کر دیتا ہے۔
ٹولز کے بارے میں دو اہم باتیں:
- ایک نیا کارڈ اندرونی ہوتا ہے جب تک کہ آپ کچھ اور نہ کہیں۔ آپ کے اندرونی کام کا خلاصہ کرنے والا اسسٹنٹ اس خلاصے کو آپ کے کلائنٹ کے لیے صرف اس لیے شائع نہیں کرنا چاہیے کہ کسی نے منع نہیں کیا تھا، لہٰذا
visibility پہلے سے اندرونی طے ہوتی ہے اور اسے جان بوجھ کر client پر سیٹ کرنا پڑتا ہے۔
- کسی لنک کو منسوخ کرنے پر تصدیق مانگی جاتی ہے، کیونکہ یہ اس لنک کے ذریعے شامل ہونے والے ہر شخص کو بھی ہٹا دیتا ہے — اور یہ ٹول محض کامیابی کی اطلاع دینے کے بجائے آپ کو بتاتا ہے کہ کتنے لوگ تھے۔
اس کے لیے کن چیزوں کی ضرورت ہے
API اور MCP تک رسائی Boards Business اور ہر Agency ہوسٹنگ پلان میں شامل ہے۔ Boards Free اور Boards Pro پر بورڈ کے اینڈ پوائنٹس اس کی وضاحت کرنے والے پیغام کے ساتھ جواب دیتے ہیں۔
ایک API کلید یا MCP کنکشن صرف وہی کام کر سکتا ہے جو اسے بنانے والا شخص ان تنظیموں میں کر سکتا ہے جن میں وہ ایسا کرنے کا مجاز ہے۔ اسسٹنٹ کی جانب سے بنایا گیا شیئر لنک بھی اسی طرح محدود ہے: یہ ایسا کوئی کردار تفویض نہیں کر سکتا جو اجازت دینے والے انسان کے پاس خود موجود نہ ہو۔