Kendalikan papan dari API, atau dari asisten AI

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

REST API

Setiap operasi ada di dalam spesifikasi OpenAPI publik kami, dengan klien yang dihasilkan dalam TypeScript, Python, PHP, dan Go, serta CLI yang 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 — menambahkan pekerjaan
• POST /v1/agency/boards/{id}/cards/{id}/move — memindahkannya
• POST /v1/agency/boards/{id}/invites — membuat tautan berbagi

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

Server MCP

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

Dua hal yang perlu diketahui tentang alat-alat ini:

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

Yang dibutuhkan

Akses API dan MCP sudah termasuk dalam Boards Business dan dalam 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 diizinkan melakukannya. Tautan berbagi yang dibuat asisten dibatasi dengan cara yang sama: tautan tersebut tidak dapat memberikan peran yang tidak dimiliki sendiri oleh individu yang memberi otorisasi.