Gerencie quadros a partir da API ou de um assistente de IA

Os quadros são totalmente controláveis fora do painel. Duas rotas, um modelo de permissão e o mesmo comportamento das telas — pois chamam o mesmo código.

A API REST

Cada operação está em nossa especificação OpenAPI pública, com clientes gerados em TypeScript, Python, PHP e Go, e a CLI é gerada a partir da mesma especificação. Quadros, colunas, cartões, comentários, perguntas, marcadores, membros e links de compartilhamento são todos cobertos.

Os endpoints que você mais usará:

• GET /v1/agency/boards — seus quadros
• GET /v1/agency/boards/{id} — um quadro com suas colunas e cartões
• POST /v1/agency/boards/{id}/cards — adicionar trabalho
• POST /v1/agency/boards/{id}/cards/{id}/move — movê-lo
• POST /v1/agency/boards/{id}/invites — gerar um link de compartilhamento

O token do link de compartilhamento retorna nessa última chamada e apenas nessa chamada. Armazenamos uma impressão digital dele, portanto, não há endpoint que possa lê-lo novamente — se o seu script precisar do link, salve-o a partir da resposta.

O servidor MCP

Se você utiliza um assistente de IA que fala MCP, conecte-o e ele obtém ferramentas de quadro diretamente: listar quadros, ler um por completo, criar um quadro, adicionar um cartão, mover um cartão, comentar, criar um link de compartilhamento e revogar um. Isso transforma "resumir esta semana e enviar um link para a Acme" em uma única instrução, em vez de dois sistemas e um copiar e colar.

Duas coisas que vale a pena saber sobre as ferramentas:

• Um novo cartão é interno, a menos que você diga o contrário. Um assistente que resume o seu trabalho interno não deve publicar esse resumo para o seu cliente simplesmente porque ninguém disse para não fazer, portanto, a visibility é definida como interna por padrão e precisa ser configurada deliberadamente como client.
• Revogar um link solicita confirmação, pois também remove qualquer pessoa que tenha entrado por meio desse link — e a ferramenta informa quantas pessoas foram, em vez de relatar um sucesso trivial.

O que é necessário

O acesso à API e ao MCP está incluído no Boards Business e em todos os planos de hospedagem da Agency. Nos planos Boards Free e Boards Pro, os endpoints de quadros respondem com uma mensagem informando isso.

Uma chave de API ou conexão MCP só pode fazer o que a pessoa que a criou pode fazer, nas organizações em que ela pode fazê-lo. Um link de compartilhamento criado por um assistente é limitado da mesma forma: ele não pode conceder um papel que o humano autorizador não possua.