Pular para o conteúdo

Supabase

Supabase

O Supabase é uma plataforma backend-as-a-service de código aberto que fornece banco de dados Postgres, autenticação, armazenamento e APIs de assinatura em tempo real para o desenvolvimento de aplicações modernas. Com a integração Supabase no SquadOS, seus agentes podem criar e gerenciar projetos, executar queries SQL, fazer deploy de edge functions, controlar segredos e rastrear o histórico de migrações — tudo de forma programática.

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) ou chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos (para OAuth 2.0 com credenciais próprias):

CampoObrigatórioDescrição
client_idSimClient ID do aplicativo OAuth registrado nas configurações da organização Supabase.
client_secretSimClient Secret do aplicativo OAuth registrado nas configurações da organização Supabase.
  1. Acesse o painel da sua organização no supabase.com e vá em Organization Settings.
  2. Clique em Add Application, informe um nome, a URL do seu site e o callback URL da Composio como redirect de autorização.
  3. Configure as permissões necessárias. Recomenda-se conceder apenas os escopos mínimos necessários, evitando acesso total de leitura e escrita por razões de segurança.
  4. Após a criação, copie o Client ID e o Client Secret exibidos na página de configurações da organização.
  5. No painel da Composio, clique em Create Auth Config, selecione Supabase e ative a opção Use your own developer credentials.
  6. Cole o Client ID e o Client Secret nos campos correspondentes e clique em Create Supabase Auth Config.
  7. Clique em Connect Account, informe a URL base da API do Supabase (use o padrão se aplicável) e autorize o acesso.
  8. Copie o ID de configuração de autenticação gerado (começa com ac_) para uso no seu código.
  1. Acesse Ferramentas no menu lateral (/admin/tools).
  2. Abra a aba Disponíveis e procure por Supabase.
  3. Clique no card para abrir o modal de detalhes e em Conectar.
  4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso (OAuth) ou informa as credenciais obtidas acima.
  5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

SUPABASE_LIST_ALL_PROJECTS

Retorna a lista de todos os projetos Supabase do usuário autenticado, incluindo ID, nome, região e status de cada projeto.

NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_PROJECT

Retorna informações detalhadas sobre um projeto Supabase específico, incluindo status, configuração do banco de dados e metadados.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto (20 letras minúsculas).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_CREATE_A_PROJECT

Cria um novo projeto Supabase. A criação é assíncrona e requer um nome único dentro da organização (sem pontos).

NomeTipoObrigatórioDescrição
namestringSimNome do novo projeto; deve ser único na organização e não pode conter pontos.
regionstringSimRegião geográfica para o servidor e banco de dados do projeto (ex: us-east-1, eu-west-1).
db_passstringSimSenha para o novo banco de dados. Guarde-a com segurança pois não pode ser recuperada via API posteriormente.
organization_idstringSimID real ou slug da organização Supabase. Use a ação “Listar todas as organizações” para obter o valor correto.
planstringNãoPlano de assinatura (free ou pro).
desired_instance_sizestringNãoTamanho da instância de computação (micro, small, medium, large, xlarge, etc.).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_UPDATE_PROJECT

Atualiza as configurações de um projeto Supabase existente, identificado por seu ID de referência único.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
namestringNãoNovo nome para o projeto.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_DELETE_PROJECT

Exclui permanente e irreversivelmente um projeto Supabase. Resulta em perda total de dados.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase a ser excluído.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_BETA_RUN_SQL_QUERY

Executa uma query SQL arbitrária no banco de dados do projeto. Use para operações avançadas de dados ou quando os endpoints padrão da API não são suficientes. Certifique-se de que as queries sejam PostgreSQL válido e estejam devidamente sanitizadas.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase (exatamente 20 letras minúsculas).
querystringSimA query SQL a ser executada no banco de dados. Aspas simples em conteúdo de string devem ser escapadas dobrando-as: ''. Para arrays PostgreSQL, use a sintaxe ARRAY['item1', 'item2'] ou '{"item1", "item2"}' — não use sintaxe JSON ["item1"].
read_onlybooleanNãoSe verdadeiro, executa a query em transação somente leitura. Incompatível com instruções INSERT, UPDATE e DELETE.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_RUN_READ_ONLY_QUERY

[Beta] Executa uma query SQL como supabase_read_only_user. Use quando precisar executar SELECT de forma segura sem risco de modificar dados. Apenas operações de leitura são permitidas.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase (exatamente 20 letras minúsculas).
querystringSimA query SQL a executar. Apenas SELECT e outras operações de leitura são permitidas. Operações de escrita (INSERT, UPDATE, DELETE, CREATE, etc.) serão rejeitadas.
parametersarrayNãoArray opcional de parâmetros para queries parametrizadas. Use $1, $2, etc. na query para referenciar os parâmetros.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_SELECT_FROM_TABLE

Seleciona linhas de uma tabela ou view do Supabase via PostgREST, com suporte a filtragem, ordenação e paginação.

NomeTipoObrigatórioDescrição
project_refstringSimIdentificador de referência único do projeto Supabase.
tablestringSimNome da tabela ou view para consultar.
selectstringSimLista de colunas separadas por vírgula a retornar. Suporta seleções aninhadas e seletores de caminho JSON.
filtersarrayNãoLista opcional de filtros. Cada filtro deve ter column, operator (eq, neq, gt, gte, lt, lte, like, ilike, is, in, etc.) e value.
orderstringNãoExpressão de ordenação no formato coluna.asc ou coluna.desc.
limitintegerNãoNúmero máximo de linhas a retornar.
offsetintegerNãoNúmero de linhas a pular antes de retornar resultados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_APPLY_A_MIGRATION

Aplica migrations de banco de dados a um projeto Supabase. Use quando precisar executar alterações de schema SQL, criar tabelas, alterar colunas ou realizar outras operações DDL/DML como parte de uma migration rastreada.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase (encontrado em Project Settings > General > Reference ID).
querystringSimA query SQL de migration a executar no banco de dados do projeto.
namestringNãoNome único para a migration, usado para rastreamento no histórico.
rollbackstringNãoQuery SQL opcional para desfazer esta migration se necessário.
idempotency_keystringNãoChave única para garantir que a mesma migration seja registrada apenas uma vez.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_LIST_MIGRATION_HISTORY

Retorna a lista de versões de migrations de banco de dados aplicadas em um projeto Supabase. Use para rastrear quais migrations já foram aplicadas ao banco de dados.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_LIST_TABLES

Lista todas as tabelas e views nos schemas especificados, fornecendo uma visão geral rápida da estrutura do banco de dados para identificar tabelas disponíveis antes de buscar schemas detalhados.

NomeTipoObrigatórioDescrição
project_refstringSimIdentificador de referência único do projeto Supabase (exatamente 20 letras minúsculas).
schemasarrayNãoLista de schemas a pesquisar (máximo 10). Se não fornecido, lista tabelas de todos os schemas não-sistema.
include_viewsbooleanNãoSe deve incluir views junto com as tabelas nos resultados.
include_metadatabooleanNãoSe deve incluir metadados básicos como contagem estimada de linhas e tamanho da tabela.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_TABLE_SCHEMAS

Retorna detalhes de colunas, tipos e restrições de múltiplas tabelas do banco de dados. Use após a ação “Listar tabelas” para obter os schemas detalhados e escrever queries SQL precisas.

NomeTipoObrigatórioDescrição
project_refstringSimIdentificador de referência único do projeto Supabase.
table_namesarraySimLista de nomes de tabelas para obter os schemas. Mínimo 1 tabela; máximo 20 por requisição. Pode incluir prefixo de schema (ex: public.users). Sem prefixo, public é assumido.
include_indexesbooleanNãoSe deve incluir informações de índices na resposta.
include_relationshipsbooleanNãoSe deve incluir relacionamentos de chave estrangeira na resposta.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_DATABASE_METADATA

Retorna metadados do banco de dados para o projeto, incluindo informações sobre bancos de dados, schemas e estrutura de tabelas.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GENERATE_TYPESCRIPT_TYPES

Gera e retorna tipos TypeScript a partir do banco de dados de um projeto Supabase. Os schemas especificados em included_schemas devem existir no projeto.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
included_schemasstringNãoNomes de schemas de banco de dados separados por vírgula para incluir nos tipos TypeScript gerados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_CREATE_FUNCTION

Cria uma nova Edge Function serverless para um projeto Supabase, exigindo código JavaScript/TypeScript válido e um identificador slug único no projeto.

NomeTipoObrigatórioDescrição
refstringSimIdentificador único do projeto (parâmetro de caminho).
namestringSimNome legível por humanos para a função.
slugstringSimIdentificador amigável para a rota da função. Deve ser único no projeto.
bodystringSimCódigo-fonte JavaScript ou TypeScript da Edge Function.
verify_jwtbooleanNãoSe verdadeiro, verifica JWT no cabeçalho Authorization antes de invocar a função. Defina como falso para endpoints públicos como webhooks.
import_mapbooleanNãoSe verdadeiro, habilita import map para resolução de módulos ES.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_LIST_FUNCTIONS

Lista metadados de todas as Edge Functions de um projeto Supabase, excluindo código-fonte ou logs das funções.

NomeTipoObrigatórioDescrição
refstringSimIdentificador único do projeto Supabase.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_FUNCTION

Retorna informações detalhadas, metadados, configuração e status de uma Edge Function específica, identificada pelo ID de referência do projeto e pelo slug da função.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase (exatamente 20 caracteres alfanuméricos minúsculos).
function_slugstringSimIdentificador único (slug) da Edge Function.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_DEPLOY_FUNCTION

Faz o deploy de Edge Functions em um projeto Supabase usando upload multipart.

NomeTipoObrigatórioDescrição
refstringSimID de referência do projeto Supabase.
slugstringNãoSlug da função a fazer deploy.
file_contentstringNãoCódigo-fonte TypeScript/JavaScript bruto como string. Ideal para funções simples ou quando o código é gerado dinamicamente. Forneça apenas UM de file_content, file_url ou file.
file_urlstringNãoURL pública para baixar o código da função. Suporta URLs raw do GitHub e outros arquivos publicamente acessíveis. Forneça apenas UM de file_content, file_url ou file.
bundleOnlybooleanNãoSe verdadeiro, apenas empacota a função sem publicá-la.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_INVOKE_EDGE_FUNCTION

Invoca uma Edge Function Supabase implantada via HTTPS. Use para testar e depurar Edge Functions com método HTTP, cabeçalhos, corpo e autenticação configuráveis.

NomeTipoObrigatórioDescrição
project_refstringSimIdentificador de referência único do projeto Supabase.
function_slugstringSimNome/slug da Edge Function a invocar.
methodstringNãoMétodo HTTP a usar ao invocar a função (GET, POST, PUT, PATCH, DELETE).
bodystringNãoCorpo da requisição a enviar para a função. Pode ser um objeto JSON ou string bruta.
headersobjectNãoCabeçalhos adicionais opcionais a enviar com a requisição (ex: Content-Type).
auth_modestringNãoModo de autorização: anon usa a chave anon, service_role usa a chave service_role, custom_bearer requer um cabeçalho Authorization customizado.
response_typestringNãoFormato de resposta esperado: json, text ou auto.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_CREATE_BULK_SECRETS

Cria múltiplos segredos de projeto Supabase de uma só vez. Cada nome de segredo não deve começar com SUPABASE_.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase onde os segredos serão criados.
secretsarraySimLista de segredos a criar. Cada segredo deve ter um nome único que não comece com SUPABASE_.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_LIST_SECRETS

Retorna todos os segredos de um projeto Supabase. Os valores dos segredos na resposta podem estar mascarados.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase cujos segredos serão listados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_DELETE_SECRETS

Exclui múltiplos segredos de um projeto Supabase de uma só vez. Requer o escopo edge_functions_secrets_write.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase cujos segredos devem ser excluídos.
secret_namesarraySimLista de nomes de segredos a excluir. Cada nome deve corresponder a um segredo existente no projeto.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_PROJECT_LOGS

Retorna logs analíticos de um projeto Supabase, incluindo logs de edge functions, banco de dados e API para monitoramento e depuração.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
sqlstringNãoQuery SQL customizada para filtrar, agregar e transformar dados de log.
iso_timestamp_startstringNãoTimestamp de início no formato ISO 8601 (ex: 2024-01-01T00:00:00Z).
iso_timestamp_endstringNãoTimestamp de fim no formato ISO 8601 (ex: 2024-01-31T23:59:59Z).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_PERFORMANCE_ADVISORS

Retorna os advisors de performance de um projeto Supabase, incluindo uma lista de problemas potenciais e oportunidades de otimização identificados.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase (20 caracteres alfanuméricos).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_SECURITY_ADVISORS

Retorna os resultados e recomendações dos advisors de segurança de um projeto Supabase. Use para auditar a postura de segurança do projeto, identificar problemas de segurança baseados em SQL e obter orientações de remediação.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
lint_typestringNãoTipo de linting a realizar para os advisors de segurança (sql).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_CREATE_DATABASE_BRANCH

Cria um novo branch de banco de dados isolado a partir de um projeto Supabase existente, útil para configurar ambientes separados de desenvolvimento ou teste que podem ser vinculados a um branch Git.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase pai.
branch_namestringSimNome único para o novo branch de banco de dados.
git_branchstringNãoNome do branch Git a associar a este branch de banco de dados.
regionstringNãoRegião geográfica para o novo branch de banco de dados.
persistentbooleanNãoSe o branch é persistente (true) ou efêmero (false). Branches efêmeros podem ser auto-excluídos.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_LIST_BACKUPS

Lista todos os backups de banco de dados de um projeto Supabase, fornecendo detalhes sobre os backups existentes.

NomeTipoObrigatórioDescrição
refstringSimIdentificador único (string de referência) do projeto Supabase.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_LIST_ALL_ORGANIZATIONS

Lista todas as organizações (apenas ID e nome) associadas à conta Supabase, excluindo detalhes dos projetos.

NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_PROJECT_API_KEYS

Retorna todas as chaves de API de um projeto Supabase existente.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
revealbooleanNãoSe verdadeiro, revela os valores completos das chaves de API na resposta. Por padrão, os valores de chaves secretas são parcialmente ocultados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_GET_HEALTH

Verifica o status de saúde da API do Supabase. Use quando precisar verificar a disponibilidade da API ou solucionar problemas de conectividade.

NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SUPABASE_UPDATE_DATABASE_PASSWORD

Atualiza a senha do banco de dados de um projeto Supabase. Use quando precisar rotacionar credenciais ou recuperar acesso ao banco de dados.

NomeTipoObrigatórioDescrição
refstringSimIdentificador de referência único do projeto Supabase.
passwordstringSimNova senha do banco de dados. Deve ter pelo menos 4 caracteres.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.