Ferramentas de desenvolvimento
Supabase no seu produto e nos seus agentes de IA, por uma API
O toolkit do Supabase funciona pela Management API: organizações e membros, projetos (ler, renomear, pausar, restaurar e saúde), Edge Functions, secrets pelo nome e queries SQL somente leitura. Seu cliente conecta o Supabase uma vez com um token de API, e seu produto ou agente de IA chama cada operação pelo Connect, que guarda as credenciais e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/supabase_pause_project/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"ref": "<ref>"
}
}Como funciona
Do cliente conectado à primeira chamada no Supabase.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Supabase. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Supabase.
Painel de projetos para agências
Liste as organizações e os projetos que uma agência gerencia, com status, região e saúde, em uma tela do seu próprio produto.
Pause projetos gratuitos ociosos
Pause um projeto do plano gratuito que não está em uso e restaure quando precisar, com cada chamada guardada no log de auditoria.
Agente inspeciona o banco
Um agente de IA roda uma query SQL somente leitura com tabelas qualificadas pelo schema, como public.orders, para responder perguntas sobre os dados do projeto.
Tools
12 tools do Supabase
- Listar organizaçõesGETLista as organizações que o token alcança, cada uma com id, slug e nome. O slug é o que as ferramentas de organização pedem.
- Obter organizaçãoGETRetorna uma organização com seu nome e plano: free, pro, team, enterprise ou platform.
- Listar membros da organizaçãoGETLista os membros de uma organização, cada um com nome de usuário, email, papel e se o MFA está ativo.
- Listar projetosGETLista os projetos de uma organização, cada um com ref, nome, região e status. O ref é o que as ferramentas de projeto pedem. Pagine com limit e offset; pagination.count é o total.
- Obter projetoGETRetorna um projeto com nome, organização, região, data de criação, status e host e versão do banco de dados.
- Atualizar projetoPATCHRenomeia um projeto. O nome é o único campo que esta chamada altera.
- Pausar projetoPOSTPausa um projeto, o que tira seu banco de dados, APIs e functions do ar até Restaurar projeto. Só projetos de organizações no plano gratuito podem ser pausados. Projetos pausados não contam no limite de dois projetos gratuitos.
- Restaurar projetoPOSTTraz de volta um projeto pausado com seus dados e configurações. Um projeto pode ser restaurado por até um ano após ser pausado, e no plano gratuito volta a contar no limite de dois projetos gratuitos ativos.
- Obter saúde do projetoGETRetorna a saúde dos serviços de um projeto, cada um com healthy, status e o erro quando há um.
- Listar functionsGETLista as Edge Functions de um projeto, cada uma com slug, nome, status, versão e se verifica o JWT de quem chama.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Perguntas sobre o toolkit do Supabase
Preciso implementar a API do Supabase?
Não. O Connect já traz 12 tools do Supabase descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Supabase?
Pelo modo que o toolkit aceita: Chave de API. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
