NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Baserow connects to a Nagent workspace with an API key. Once it is connected, agents can call 14 Baserow actions, such as "Create User", "Get Form View Metadata" and "Get Public Builder by Domain Name". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Baserow, with input parameters and output schema.
BASEROW_CREATE_USERTool to create a new Baserow user with the provided details. Use when you need to register a new user account in Baserow. After creating an account, an initial workspace containing a database is automatically created. Optionally generates authentication JWT tokens if authenticate parameter is set to true.
Input parameters
The user's display name
The user's email address (used for login)
An ISO 639 language code (with optional variant) selected by the user. Ex: en-GB
The user's password
The id of the template that must be installed after creating the account. This only works if the workspace_invitation_token param is not provided
Indicates whether an authentication JWT should be generated and be included in the response
If provided and valid, the user accepts the workspace invitation and will have access to the workspace after signing up
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_DISPATCH_BUILDER_PAGE_DATA_SOURCETool to dispatch the service of a builder page data source and return the result. Use when you need to execute a data source query in Baserow's builder application.
Input parameters
Metadata payload for the dispatch request.
The id of the data_source you want to call the dispatch for
An optional header that marks the action performed by this request as having occurred in a particular client session. Then using the undo/redo endpoints with the same ClientSessionId header this action can be undone/redone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_DISPATCH_PUBLIC_BUILDER_PAGE_DATA_SOURCETool to dispatch the service of a published builder page data source and return the result. Use this when you need to execute a data source in a public/published Baserow builder domain.
Input parameters
Metadata for the data source dispatch.
The id of the data_source you want to call the dispatch for
An optional header that marks the action performed by this request as having occurred in a particular client session. Then using the undo/redo endpoints with the same ClientSessionId header this action can be undone/redone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_GET_FORM_VIEW_METADATATool to retrieve metadata for a Baserow form view. Use when you need to get form structure and configuration details for constructing a form with the right fields. The form must be publicly shared or the user must have access to the related workspace.
Input parameters
The slug related to the form view. This unique identifier is used to access the form metadata.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_GET_PUBLIC_BUILDER_BY_DOMAIN_NAMETool to retrieve the public published version of a builder by its domain name. Use when you need to access a published Baserow builder application and its configuration, including pages, scripts, theme, and user sources.
Input parameters
The domain name of the published builder to retrieve. Can be a custom domain or Baserow subdomain (e.g., 'demo.baserow.io').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_GET_RECORD_NAMES_BUILDER_PAGE_DATA_SOURCETool to find the record names associated with a given list of record ids. Use when you need to retrieve the display names for specific records from a builder page data source.
Input parameters
A comma separated list of the record ids to search for
The id of the data_source to find the record names
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_GET_SETTINGSTool to retrieve all admin configured settings for the Baserow instance. Use when you need to check system-wide configuration like signup policies, email verification settings, or workspace creation permissions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_LIST_APPLICATION_USER_SOURCESTool to list all user sources of an application if the user has access to the related application's workspace. Use when you need to retrieve user source configurations for a Baserow application. If the workspace is related to a template, this endpoint is publicly accessible.
Input parameters
Returns only the user_sources of the application related to the provided Id.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_LIST_AUTH_PROVIDERS_LOGIN_OPTIONSTool to list available login options for configured authentication providers. Use when you need to discover which authentication methods are enabled for the Baserow instance.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_LIST_DATABASESThis tool retrieves a list of all databases in a specified workspace. As a fundamental operation, it allows users to discover which databases are available in their Baserow workspace. This operation is independent and requires only authentication in order to fetch essential metadata for subsequent operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_LIST_TABLESThis tool lists all tables within a specified Baserow database. It allows users to retrieve information about all tables in a database by using the GET /api/database/{database_id}/tables/ endpoint. The expected output is an array of table objects containing details such as id, name, order, database_id, type, and first_row_header.
Input parameters
ID of the database to list tables from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_LIST_TEMPLATESTool to list all template categories and their related templates. The template's workspace_id can be used for previewing purposes because that workspace contains publicly accessible applications. Use when you need to discover available templates in Baserow.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_SEND_PASSWORD_RESET_EMAILTool to send a password reset email to a user's email address. The email contains a password reset link that is valid for 48 hours. The endpoint will not fail if the email address is not found.
Input parameters
The email address of the user that has requested a password reset.
The base URL where the user can reset their password. The reset token will be appended to the base_url (base_url '/token').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BASEROW_SEND_VERIFY_EMAILTool to send a verification email to a user's email address. Use when you need to trigger email verification for a user account that hasn't been verified yet.
Input parameters
The email address to send the verification email to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 14 Baserow actions on Nagent, including "Create User", "Get Form View Metadata" and "Get Public Builder by Domain Name". Create User: Create a new Baserow user with the provided details. Each action is listed on this page with its input parameters and its output.
Baserow connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create User takes 3 required inputs: name, email and password. It also takes 4 optional inputs: language, template_id, authenticate and workspace_invitation_token. It returns data, error and successful.