Kelola papan dari API, atau dari asisten AI

Papan dapat sepenuhnya digerakkan dari luar dasbor. Dua rute, satu model izin, dan perilaku yang sama seperti layar — karena memanggil kode yang sama.

API REST

Setiap operasi ada dalam spesifikasi OpenAPI publik kami, dengan klien yang dihasilkan dalam TypeScript, Python, PHP, dan Go, dan CLI dihasilkan dari spesifikasi yang sama. Papan, kolom, kartu, komentar, pertanyaan, label, anggota, dan tautan berbagi semuanya tercakup.

Titik akhir yang paling sering Anda gunakan:

• GET /v1/agency/boards — papan Anda
• GET /v1/agency/boards/{id} — satu papan beserta kolom dan kartunya
• POST /v1/agency/boards/{id}/cards — tambahkan pekerjaan
• POST /v1/agency/boards/{id}/cards/{id}/move — pindahkan
• POST /v1/agency/boards/{id}/invites — buat tautan berbagi

Token tautan berbagi dikembalikan pada panggilan terakhir tersebut dan hanya pada panggilan itu. Kami menyimpan sidik jarinya, sehingga tidak ada titik akhir yang dapat membacanya kembali — jika skrip Anda membutuhkan tautan tersebut, simpan dari respons.

Server MCP

Jika Anda menggunakan asisten AI yang mendukung MCP, sambungkan dan asisten tersebut akan langsung mendapatkan alat papan: mencantumkan papan, membaca satu secara lengkap, membuat papan, menambahkan kartu, memindahkan kartu, berkomentar, membuat tautan berbagi, dan mencabutnya. Hal itu mengubah "buat ringkasan minggu ini dan kirimkan tautan ke Acme" menjadi satu instruksi alih-alih dua sistem dan salin-tempel.

Dua hal yang perlu diketahui tentang alat tersebut:

• Kartu baru bersifat internal kecuali Anda menentukan lain. Asisten yang merangkum pekerjaan internal Anda tidak boleh mempublikasikan ringkasan tersebut kepada klien Anda hanya karena tidak ada yang melarangnya, sehingga visibility secara default diatur ke internal dan harus disetel ke client secara sengaja.
• Mencabut tautan meminta konfirmasi, karena tindakan ini juga menghapus siapa pun yang bergabung melalui tautan tersebut — dan alat tersebut memberi tahu Anda berapa banyak orang tersebut, alih-alih melaporkan keberhasilan yang sederhana.

Yang dibutuhkannya

Akses API dan MCP disertakan dalam Boards Business dan di setiap paket hosting Agency. Pada Boards Free dan Boards Pro, titik akhir papan merespons dengan pesan yang menyatakan hal tersebut.

Kunci API atau koneksi MCP hanya dapat melakukan apa yang dapat dilakukan oleh orang yang membuatnya, di organisasi tempat mereka dapat melakukannya. Tautan berbagi yang dibuat oleh asisten dibatasi dengan cara yang sama: tautan tersebut tidak dapat memberikan peran yang tidak dimiliki oleh manusia pemberi otorisasi itu sendiri.