Supabase
Visão geral
Seção intitulada “Visão geral”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.
- Site oficial: https://supabase.com/
- Documentação na Composio: docs.composio.dev/toolkits/supabase
Autenticação
Seção intitulada “Autenticação”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):
| Campo | Obrigatório | Descrição |
|---|---|---|
client_id | Sim | Client ID do aplicativo OAuth registrado nas configurações da organização Supabase. |
client_secret | Sim | Client Secret do aplicativo OAuth registrado nas configurações da organização Supabase. |
Como obter a credencial
Seção intitulada “Como obter a credencial”- Acesse o painel da sua organização no supabase.com e vá em Organization Settings.
- Clique em Add Application, informe um nome, a URL do seu site e o callback URL da Composio como redirect de autorização.
- 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.
- Após a criação, copie o Client ID e o Client Secret exibidos na página de configurações da organização.
- No painel da Composio, clique em Create Auth Config, selecione Supabase e ative a opção Use your own developer credentials.
- Cole o Client ID e o Client Secret nos campos correspondentes e clique em Create Supabase Auth Config.
- Clique em Connect Account, informe a URL base da API do Supabase (use o padrão se aplicável) e autorize o acesso.
- Copie o ID de configuração de autenticação gerado (começa com
ac_) para uso no seu código.
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Supabase. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso (OAuth) ou informa as credenciais obtidas acima.
- 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.)
Ações disponíveis
Seção intitulada “Ações disponíveis”Listar todos os projetos
Seção intitulada “Listar todos os projetos”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.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter projeto
Seção intitulada “Obter projeto”SUPABASE_GET_PROJECT
Retorna informações detalhadas sobre um projeto Supabase específico, incluindo status, configuração do banco de dados e metadados.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto (20 letras minúsculas). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar novo projeto
Seção intitulada “Criar novo projeto”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).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome do novo projeto; deve ser único na organização e não pode conter pontos. |
region | string | Sim | Região geográfica para o servidor e banco de dados do projeto (ex: us-east-1, eu-west-1). |
db_pass | string | Sim | Senha para o novo banco de dados. Guarde-a com segurança pois não pode ser recuperada via API posteriormente. |
organization_id | string | Sim | ID real ou slug da organização Supabase. Use a ação “Listar todas as organizações” para obter o valor correto. |
plan | string | Não | Plano de assinatura (free ou pro). |
desired_instance_size | string | Não | Tamanho da instância de computação (micro, small, medium, large, xlarge, etc.). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar projeto
Seção intitulada “Atualizar projeto”SUPABASE_UPDATE_PROJECT
Atualiza as configurações de um projeto Supabase existente, identificado por seu ID de referência único.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
name | string | Não | Novo nome para o projeto. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir projeto
Seção intitulada “Excluir projeto”SUPABASE_DELETE_PROJECT
Exclui permanente e irreversivelmente um projeto Supabase. Resulta em perda total de dados.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase a ser excluído. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Executar query no banco de dados
Seção intitulada “Executar query no banco de dados”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase (exatamente 20 letras minúsculas). |
query | string | Sim | A 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_only | boolean | Não | Se verdadeiro, executa a query em transação somente leitura. Incompatível com instruções INSERT, UPDATE e DELETE. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Executar query somente leitura
Seção intitulada “Executar query somente leitura”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase (exatamente 20 letras minúsculas). |
query | string | Sim | A 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. |
parameters | array | Não | Array opcional de parâmetros para queries parametrizadas. Use $1, $2, etc. na query para referenciar os parâmetros. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Selecionar linhas de tabela
Seção intitulada “Selecionar linhas de tabela”SUPABASE_SELECT_FROM_TABLE
Seleciona linhas de uma tabela ou view do Supabase via PostgREST, com suporte a filtragem, ordenação e paginação.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
project_ref | string | Sim | Identificador de referência único do projeto Supabase. |
table | string | Sim | Nome da tabela ou view para consultar. |
select | string | Sim | Lista de colunas separadas por vírgula a retornar. Suporta seleções aninhadas e seletores de caminho JSON. |
filters | array | Não | Lista opcional de filtros. Cada filtro deve ter column, operator (eq, neq, gt, gte, lt, lte, like, ilike, is, in, etc.) e value. |
order | string | Não | Expressão de ordenação no formato coluna.asc ou coluna.desc. |
limit | integer | Não | Número máximo de linhas a retornar. |
offset | integer | Não | Número de linhas a pular antes de retornar resultados. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Aplicar migration de banco de dados
Seção intitulada “Aplicar migration de banco de dados”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase (encontrado em Project Settings > General > Reference ID). |
query | string | Sim | A query SQL de migration a executar no banco de dados do projeto. |
name | string | Não | Nome único para a migration, usado para rastreamento no histórico. |
rollback | string | Não | Query SQL opcional para desfazer esta migration se necessário. |
idempotency_key | string | Não | Chave única para garantir que a mesma migration seja registrada apenas uma vez. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar histórico de migrations
Seção intitulada “Listar histórico de migrations”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar tabelas do banco de dados
Seção intitulada “Listar tabelas do banco de dados”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
project_ref | string | Sim | Identificador de referência único do projeto Supabase (exatamente 20 letras minúsculas). |
schemas | array | Não | Lista de schemas a pesquisar (máximo 10). Se não fornecido, lista tabelas de todos os schemas não-sistema. |
include_views | boolean | Não | Se deve incluir views junto com as tabelas nos resultados. |
include_metadata | boolean | Não | Se deve incluir metadados básicos como contagem estimada de linhas e tamanho da tabela. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter schemas de tabelas
Seção intitulada “Obter schemas de tabelas”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
project_ref | string | Sim | Identificador de referência único do projeto Supabase. |
table_names | array | Sim | Lista 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_indexes | boolean | Não | Se deve incluir informações de índices na resposta. |
include_relationships | boolean | Não | Se deve incluir relacionamentos de chave estrangeira na resposta. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter metadados do banco de dados
Seção intitulada “Obter metadados do banco de dados”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Gerar tipos TypeScript
Seção intitulada “Gerar tipos TypeScript”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
included_schemas | string | Não | Nomes de schemas de banco de dados separados por vírgula para incluir nos tipos TypeScript gerados. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar edge function
Seção intitulada “Criar edge function”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador único do projeto (parâmetro de caminho). |
name | string | Sim | Nome legível por humanos para a função. |
slug | string | Sim | Identificador amigável para a rota da função. Deve ser único no projeto. |
body | string | Sim | Código-fonte JavaScript ou TypeScript da Edge Function. |
verify_jwt | boolean | Não | Se verdadeiro, verifica JWT no cabeçalho Authorization antes de invocar a função. Defina como falso para endpoints públicos como webhooks. |
import_map | boolean | Não | Se verdadeiro, habilita import map para resolução de módulos ES. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar edge functions
Seção intitulada “Listar edge functions”SUPABASE_LIST_FUNCTIONS
Lista metadados de todas as Edge Functions de um projeto Supabase, excluindo código-fonte ou logs das funções.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador único do projeto Supabase. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter edge function
Seção intitulada “Obter edge function”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase (exatamente 20 caracteres alfanuméricos minúsculos). |
function_slug | string | Sim | Identificador único (slug) da Edge Function. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Fazer deploy de edge function
Seção intitulada “Fazer deploy de edge function”SUPABASE_DEPLOY_FUNCTION
Faz o deploy de Edge Functions em um projeto Supabase usando upload multipart.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | ID de referência do projeto Supabase. |
slug | string | Não | Slug da função a fazer deploy. |
file_content | string | Não | Có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_url | string | Não | URL 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. |
bundleOnly | boolean | Não | Se verdadeiro, apenas empacota a função sem publicá-la. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Invocar edge function
Seção intitulada “Invocar edge function”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
project_ref | string | Sim | Identificador de referência único do projeto Supabase. |
function_slug | string | Sim | Nome/slug da Edge Function a invocar. |
method | string | Não | Método HTTP a usar ao invocar a função (GET, POST, PUT, PATCH, DELETE). |
body | string | Não | Corpo da requisição a enviar para a função. Pode ser um objeto JSON ou string bruta. |
headers | object | Não | Cabeçalhos adicionais opcionais a enviar com a requisição (ex: Content-Type). |
auth_mode | string | Não | Modo de autorização: anon usa a chave anon, service_role usa a chave service_role, custom_bearer requer um cabeçalho Authorization customizado. |
response_type | string | Não | Formato de resposta esperado: json, text ou auto. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar segredos em massa
Seção intitulada “Criar segredos em massa”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_.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase onde os segredos serão criados. |
secrets | array | Sim | Lista de segredos a criar. Cada segredo deve ter um nome único que não comece com SUPABASE_. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar segredos
Seção intitulada “Listar segredos”SUPABASE_LIST_SECRETS
Retorna todos os segredos de um projeto Supabase. Os valores dos segredos na resposta podem estar mascarados.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase cujos segredos serão listados. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir segredos em massa
Seção intitulada “Excluir segredos em massa”SUPABASE_DELETE_SECRETS
Exclui múltiplos segredos de um projeto Supabase de uma só vez. Requer o escopo edge_functions_secrets_write.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase cujos segredos devem ser excluídos. |
secret_names | array | Sim | Lista de nomes de segredos a excluir. Cada nome deve corresponder a um segredo existente no projeto. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter logs do projeto
Seção intitulada “Obter logs do projeto”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
sql | string | Não | Query SQL customizada para filtrar, agregar e transformar dados de log. |
iso_timestamp_start | string | Não | Timestamp de início no formato ISO 8601 (ex: 2024-01-01T00:00:00Z). |
iso_timestamp_end | string | Não | Timestamp de fim no formato ISO 8601 (ex: 2024-01-31T23:59:59Z). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter advisors de performance
Seção intitulada “Obter advisors de performance”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase (20 caracteres alfanuméricos). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter advisors de segurança
Seção intitulada “Obter advisors de segurança”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
lint_type | string | Não | Tipo de linting a realizar para os advisors de segurança (sql). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar branch de banco de dados
Seção intitulada “Criar branch de banco de dados”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase pai. |
branch_name | string | Sim | Nome único para o novo branch de banco de dados. |
git_branch | string | Não | Nome do branch Git a associar a este branch de banco de dados. |
region | string | Não | Região geográfica para o novo branch de banco de dados. |
persistent | boolean | Não | Se o branch é persistente (true) ou efêmero (false). Branches efêmeros podem ser auto-excluídos. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar backups do banco de dados
Seção intitulada “Listar backups do banco de dados”SUPABASE_LIST_BACKUPS
Lista todos os backups de banco de dados de um projeto Supabase, fornecendo detalhes sobre os backups existentes.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador único (string de referência) do projeto Supabase. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar todas as organizações
Seção intitulada “Listar todas as organizações”SUPABASE_LIST_ALL_ORGANIZATIONS
Lista todas as organizações (apenas ID e nome) associadas à conta Supabase, excluindo detalhes dos projetos.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter chaves de API do projeto
Seção intitulada “Obter chaves de API do projeto”SUPABASE_GET_PROJECT_API_KEYS
Retorna todas as chaves de API de um projeto Supabase existente.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
reveal | boolean | Não | Se verdadeiro, revela os valores completos das chaves de API na resposta. Por padrão, os valores de chaves secretas são parcialmente ocultados. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Verificar status de saúde da API
Seção intitulada “Verificar status de saúde da API”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.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar senha do banco de dados
Seção intitulada “Atualizar senha do banco de dados”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ref | string | Sim | Identificador de referência único do projeto Supabase. |
password | string | Sim | Nova senha do banco de dados. Deve ter pelo menos 4 caracteres. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |