Gestionați panourile din API sau printr-un asistent AI

Panourile sunt complet controlabile din afara tabloului de bord. Două căi, un singur model de permisiuni și același comportament ca ecranele — deoarece apelează același cod.

API-ul REST

Fiecare operațiune se află în specificația noastră publică OpenAPI, cu clienți generați în TypeScript, Python, PHP și Go, iar CLI-ul este generat din aceeași specificație. Panourile, coloanele, cardurile, comentariile, întrebările, etichetele, membrii și linkurile de partajare sunt toate acoperite.

Punctele finale pe care le veți folosi cel mai des:

• GET /v1/agency/boards — panourile dumneavoastră
• GET /v1/agency/boards/{id} — un panou cu coloanele și cardurile sale
• POST /v1/agency/boards/{id}/cards — adăugați sarcini
• POST /v1/agency/boards/{id}/cards/{id}/move — mutați-le
• POST /v1/agency/boards/{id}/invites — generați un link de partajare

Tokenul linkului de partajare este returnat la acel ultim apel și numai la acel apel. Stocăm o amprentă a acestuia, astfel încât nu există niciun punct final care să-l poată citi din nou — dacă scriptul dumneavoastră are nevoie de link, păstrați-l din răspuns.

Serverul MCP

Dacă utilizați un asistent AI care folosește MCP, conectați-l și acesta va obține direct instrumente pentru panouri: listați panourile, citiți unul în întregime, creați un panou, adăugați un card, mutați un card, comentați, creați un link de partajare și revocați unul. Acest lucru transformă comanda „rezumă această săptămână și trimite un link către Acme” într-o singură instrucțiune în loc de două sisteme și un copy-paste.

Două lucruri care merită știute despre instrumente:

• Un card nou este intern, cu excepția cazului în care specificați altfel. Un asistent care rezumă activitatea dumneavoastră internă nu trebuie să publice acel rezumat clientului dumneavoastră doar pentru că nimeni nu a specificat să nu o facă, astfel încât visibility este implicit internă și trebuie setată deliberat la client.
• Revocarea unui link solicită confirmare, deoarece elimină și pe oricine s-a alăturat prin intermediul acelui link — iar instrumentul vă spune câte persoane au fost, în loc să raporteze pur și simplu un succes fără detalii.

De ce anume este nevoie

Accesul la API și MCP este inclus în Boards Business și în fiecare plan de găzduire Agency. În versiunile Boards Free și Boards Pro, punctele finale ale panoului răspund cu un mesaj care indică acest lucru.

O cheie API sau o conexiune MCP poate face doar ceea ce poate face persoana care a creat-o, în cadrul organizațiilor în care are permisiunea să o facă. Un link de partajare pe care îl creează un asistent este limitat în același mod: nu poate acorda un rol pe care persoana care autorizează nu îl deține ea însăși.