Gestionați panourile din API sau de la un asistent AI

Panourile pot fi controlate complet din afara panoului de control. Două rute, un singur model de permisiuni și același comportament ca și 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ăugarea de activități
• POST /v1/agency/boards/{id}/cards/{id}/move — mutarea acestora
• POST /v1/agency/boards/{id}/invites — generarea unui link de partajare

Tokenul linkului de partajare apare în acel ultim apel și doar în acel apel. Stocăm o amprentă a acestuia, așa că nu există niciun punct final care să îl poată citi ulterior — dacă scriptul dumneavoastră are nevoie de link, salvați-l din răspuns.

Serverul MCP

Dacă folosiți un asistent AI care utilizează MCP, conectați-l și acesta va primi direct instrumente pentru panouri: listarea panourilor, citirea completă a unuia, crearea unui panou, adăugarea unui card, mutarea unui card, comentarea, crearea unui link de partajare și revocarea unuia. Aceasta transformă cererea „rezumă această săptămână și trimite-i lui Acme un link” într-o singură instrucțiune, în loc de două sisteme și o operațiune de copiere-lipire.

Două aspecte importante despre instrumente:

• Un card nou este intern, cu excepția cazului în care specificați contrariul. Un asistent care rezumă activitatea dumneavoastră internă nu trebuie să publice acel rezumat către clientul dumneavoastră doar pentru că nu s-a specificat contrariul, așa că parametrul visibility are valoarea implicită intern și trebuie setat în mod deliberat la client.
• Revocarea unui link solicită confirmare, deoarece elimină și toate persoanele care s-au alăturat prin acel link — iar instrumentul vă spune câte persoane au fost, în loc să raporteze un succes simplu.

Ce este necesar

Accesul la API și MCP este inclus în Boards Business și în orice plan de găzduire Agency. Pentru planurile Boards Free și Boards Pro, punctele finale ale panoului vor răspunde cu un mesaj în acest sens.

O cheie API sau o conexiune MCP poate face doar ceea ce poate face persoana care a creat-o, în organizațiile în care are aceste drepturi. Un link de partajare creat de un asistent este limitat în același mod: nu poate acorda un rol pe care utilizatorul care a autorizat acțiunea nu îl deține el însuși.