Kendalikan papan daripada API, atau daripada pembantu AI

Papan boleh dikendalikan sepenuhnya dari luar papan pemuka. Dua laluan, satu model kebenaran, dan tingkah laku yang sama seperti paparan skrin — kerana kedua-duanya memanggil kod yang sama.

API REST

Setiap operasi terdapat dalam spesifikasi OpenAPI awam kami, dengan klien yang dijana dalam TypeScript, Python, PHP dan Go, serta CLI yang dijana daripada spesifikasi yang sama. Papan, lajur, kad, komen, soalan, label, ahli dan pautan kongsi semuanya diliputi.

Titik akhir yang paling kerap anda gunakan:

• GET /v1/agency/boards — papan anda
• GET /v1/agency/boards/{id} — satu papan bersama lajur dan kadnya
• POST /v1/agency/boards/{id}/cards — tambah tugas
• POST /v1/agency/boards/{id}/cards/{id}/move — pindahkannya
• POST /v1/agency/boards/{id}/invites — jana pautan kongsi

Token pautan kongsi dikembalikan pada panggilan terakhir itu dan hanya pada panggilan tersebut. Kami menyimpan cap jari token tersebut, jadi tiada titik akhir yang boleh membacanya semula — jika skrip anda memerlukan pautan tersebut, simpannya daripada respons.

Pelayan MCP

Jika anda menggunakan pembantu AI yang menyokong MCP, sambungkannya dan ia akan mendapat alat papan secara terus: senaraikan papan, baca satu papan sepenuhnya, cipta papan, tambah kad, alihkan kad, beri komen, cipta pautan kongsi dan batalkan pautan. Ini mengubah "ringkaskan minggu ini dan hantar pautan kepada Acme" menjadi satu arahan dan bukannya melibatkan dua sistem serta salin-tampal.

Dua perkara yang wajar diketahui tentang alat ini:

• Kad baharu bersifat dalaman melainkan anda menyatakan sebaliknya. Pembantu yang meringkaskan kerja dalaman anda tidak boleh menerbitkan ringkasan tersebut kepada klien anda hanya kerana tiada sesiapa yang melarangnya, jadi visibility ditetapkan secara lalai kepada dalaman dan perlu ditetapkan kepada client secara sengaja.
• Membatalkan pautan memerlukan pengesahan, kerana tindakan ini juga menyingkirkan sesiapa sahaja yang menyertai melalui pautan tersebut — dan alat tersebut memberitahu anda jumlah orang yang terlibat, dan bukannya sekadar melaporkan kejayaan secara ringkas.

Keperluan

Akses API dan MCP disertakan dalam Boards Business dan dalam setiap pelan pengehosan Agency. Pada Boards Free dan Boards Pro, titik akhir papan membalas dengan mesej yang menyatakan demikian.

Kunci API atau sambungan MCP hanya boleh melakukan apa yang boleh dilakukan oleh individu yang menciptanya, dalam organisasi yang dibenarkan untuk mereka bertindak. Pautan kongsi yang dicipta oleh pembantu terikat dengan cara yang sama: ia tidak boleh memberikan peranan yang tidak dipegang sendiri oleh manusia yang memberi kebenaran.