Baserow

Visão geral

Baserow é uma ferramenta de banco de dados open-source que permite que equipes construam aplicações de dados no-code, colaborem em registros e integrem com outros serviços para gestão de dados. Com a integração no SquadOS, seus agentes podem interagir com workspaces, bancos de dados, tabelas, formulários, templates e construtores de aplicações do Baserow diretamente a partir de fluxos de automação.

• Site oficial: https://baserow.io/
• Documentação na Composio: docs.composio.dev/toolkits/baserow

Autenticação

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
api_key	Sim	Chave de API da sua conta Baserow, usada para autenticar todas as requisições à instância.

Como obter a credencial

1. Acesse baserow.io e faça login na sua conta (ou instância auto-hospedada).
2. Clique no ícone do seu perfil no canto superior direito e selecione Settings (Configurações).
3. Navegue até a aba API tokens.
4. Clique em Create token (Criar token), dê um nome (ex.: SquadOS) e defina as permissões desejadas.
5. Copie o token gerado — esse é o valor a usar no campo api_key ao conectar no SquadOS.

Dica

Use um token dedicado para o SquadOS com apenas as permissões necessárias. O Baserow permite revogar tokens individualmente sem afetar outras integrações.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Baserow.
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 informa a chave de API obtida 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.)

Ações disponíveis

Criar usuário

BASEROW_CREATE_USER

Cria um novo usuário no Baserow com os detalhes fornecidos. Use quando precisar registrar uma nova conta de usuário no Baserow. Após criar a conta, um workspace inicial contendo um banco de dados é criado automaticamente. Opcionalmente, gera tokens JWT de autenticação se o parâmetro authenticate for definido como true.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome de exibição do usuário.
email	string	Sim	Endereço de e-mail do usuário (usado para login).
language	string	Não	Código de idioma ISO 639 (com variante opcional) selecionado pelo usuário. Ex: en-GB.
password	string	Sim	Senha do usuário.
template_id	integer	Não	ID do template a ser instalado após criar a conta. Funciona apenas se o parâmetro workspace_invitation_token não for fornecido.
authenticate	boolean	Não	Indica se um JWT de autenticação deve ser gerado e incluído na resposta.
workspace_invitation_token	string	Não	Se fornecido e válido, o usuário aceita o convite do workspace e terá acesso a ele após o cadastro.

Saída

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.

Despachar fonte de dados de página do construtor

BASEROW_DISPATCH_BUILDER_PAGE_DATA_SOURCE

Despacha o serviço de uma fonte de dados de página do construtor e retorna o resultado. Use quando precisar executar uma consulta de fonte de dados no aplicativo construtor do Baserow.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
metadata	object	Não	Payload de metadados para a requisição de despacho.
data_source_id	integer	Sim	ID da fonte de dados para a qual despachar.
ClientSessionId	string	Não	Cabeçalho opcional que marca a ação realizada como pertencente a uma sessão de cliente específica, permitindo desfazer/refazer via endpoints com o mesmo ClientSessionId.

Saída

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.

Despachar fonte de dados pública de página do construtor

BASEROW_DISPATCH_PUBLIC_BUILDER_PAGE_DATA_SOURCE

Despacha o serviço de uma fonte de dados de página publicada do construtor e retorna o resultado. Use quando precisar executar uma fonte de dados em um domínio público/publicado do construtor Baserow.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
metadata	object	Não	Metadados para o despacho da fonte de dados.
data_source_id	integer	Sim	ID da fonte de dados para a qual despachar.
ClientSessionId	string	Não	Cabeçalho opcional que marca a ação realizada como pertencente a uma sessão de cliente específica, permitindo desfazer/refazer via endpoints com o mesmo ClientSessionId.

Saída

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 de visualização de formulário

BASEROW_GET_FORM_VIEW_METADATA

Recupera os metadados de uma visualização de formulário do Baserow. Use quando precisar obter a estrutura e a configuração do formulário para construí-lo com os campos corretos. O formulário deve ser compartilhado publicamente ou o usuário deve ter acesso ao workspace relacionado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
slug	string	Sim	O slug relacionado à visualização de formulário. Esse identificador único é usado para acessar os metadados do formulário.

Saída

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 construtor público por nome de domínio

BASEROW_GET_PUBLIC_BUILDER_BY_DOMAIN_NAME

Recupera a versão publicada de um construtor pelo nome de domínio. Use quando precisar acessar um aplicativo construtor Baserow publicado e sua configuração, incluindo páginas, scripts, tema e fontes de usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
domain_name	string	Sim	O nome de domínio do construtor publicado a recuperar. Pode ser um domínio customizado ou subdomínio do Baserow (ex.: ‘demo.baserow.io’).

Saída

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 nomes de registros para fonte de dados de página do construtor

BASEROW_GET_RECORD_NAMES_BUILDER_PAGE_DATA_SOURCE

Encontra os nomes de registros associados a uma lista de IDs de registros. Use quando precisar recuperar os nomes de exibição de registros específicos de uma fonte de dados de página do construtor.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
record_ids	string	Sim	Lista separada por vírgula dos IDs de registros a pesquisar.
data_source_id	integer	Sim	ID da fonte de dados para encontrar os nomes dos registros.

Saída

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 configurações

BASEROW_GET_SETTINGS

Recupera todas as configurações administrativas da instância Baserow. Use quando precisar verificar configurações do sistema, como políticas de cadastro, configurações de verificação de e-mail ou permissões de criação de workspace.

Saída

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 fontes de usuário de aplicação

BASEROW_LIST_APPLICATION_USER_SOURCES

Lista todas as fontes de usuário de uma aplicação, se o usuário tiver acesso ao workspace relacionado. Use quando precisar recuperar configurações de fontes de usuário para uma aplicação Baserow. Se o workspace estiver relacionado a um template, este endpoint é acessível publicamente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
application_id	integer	Sim	Retorna apenas as fontes de usuário da aplicação relacionada ao ID fornecido.

Saída

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 opções de login de provedores de autenticação

BASEROW_LIST_AUTH_PROVIDERS_LOGIN_OPTIONS

Lista as opções de login disponíveis para os provedores de autenticação configurados. Use quando precisar descobrir quais métodos de autenticação estão habilitados para a instância Baserow.

Saída

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 bancos de dados

BASEROW_LIST_DATABASES

Recupera uma lista de todos os bancos de dados em um workspace especificado. Como operação fundamental, permite descobrir quais bancos de dados estão disponíveis no workspace Baserow. Esta operação é independente e requer apenas autenticação para buscar metadados essenciais para operações subsequentes.

Saída

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 no banco de dados

BASEROW_LIST_TABLES

Lista todas as tabelas dentro de um banco de dados Baserow especificado. Permite recuperar informações sobre todas as tabelas em um banco de dados, incluindo detalhes como id, name, order, database_id, type e first_row_header.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
database_id	integer	Sim	ID do banco de dados do qual listar as tabelas.

Saída

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 templates

BASEROW_LIST_TEMPLATES

Lista todas as categorias de templates e seus templates relacionados. O workspace_id do template pode ser usado para fins de visualização, pois esse workspace contém aplicações acessíveis publicamente. Use quando precisar descobrir os templates disponíveis no Baserow.

Saída

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.

Enviar e-mail de redefinição de senha

BASEROW_SEND_PASSWORD_RESET_EMAIL

Envia um e-mail de redefinição de senha para o endereço de e-mail do usuário. O e-mail contém um link de redefinição válido por 48 horas. O endpoint não falhará se o endereço de e-mail não for encontrado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
email	string	Sim	Endereço de e-mail do usuário que solicitou a redefinição de senha.
base_url	string	Sim	URL base onde o usuário pode redefinir sua senha. O token de redefinição será anexado ao base_url (base_url ‘/token’).

Saída

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.

Enviar e-mail de verificação

BASEROW_SEND_VERIFY_EMAIL

Envia um e-mail de verificação para o endereço de e-mail de um usuário. Use quando precisar acionar a verificação de e-mail para uma conta de usuário que ainda não foi verificada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
email	string	Sim	Endereço de e-mail para o qual enviar o e-mail de verificação.

Saída

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.