NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Project Bubble connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Project Bubble actions: "Get Record By ID", "Data API Get Data Type Fields" and "Data API Get Objects". 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 Project Bubble, with input parameters and output schema.
PROJECT_BUBBLE_DATA_API_GET_DATA_TYPE_FIELDSRetrieves the field schema for a specific Bubble data type, returning metadata about each field including its name, data type, and whether it's required. Use this after discovering available data types to understand their structure before querying or manipulating records.
Input parameters
The name of the Bubble data type to retrieve field schema for (case-sensitive).
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
PROJECT_BUBBLE_DATA_API_GET_OBJECTSTool to retrieve a list of objects for a specified data type. Use when you need to list items with optional filters, sorting, and pagination.
Input parameters
If 'yes', return only the total count of matching objects instead of object data.
Maximum number of objects to return (1–1000). Defaults to server-side setting if omitted.
Pagination cursor from a previous response for fetching the next page.
Name of the Bubble data type to list objects from (case-sensitive).
Sort in descending order when 'yes'; ascending when 'no' or omitted.
Field name to sort results by (must be a valid field on the data type).
JSON-encoded search constraints to filter objects. For example: '{"Status":"Active"}'.
If 'yes', omit null-valued fields in each returned object.
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
PROJECT_BUBBLE_DATA_API_GET_RECORDRetrieves a single record by its unique ID from a specified data type (table/collection). Use this when you need to fetch detailed information about a specific record and you already know its ID. The response includes all fields defined for that record, plus metadata like creation and modification dates. Common use cases: - Fetching full details of a specific team, user, or project by ID - Retrieving a record after getting its ID from a list/search operation - Accessing individual record properties for further processing Note: Returns an error if the record doesn't exist or you don't have permission to access it.
Input parameters
The unique identifier of the specific record to retrieve. This is the record's ID from the database.
The data type (table/collection) name from which to retrieve the record. Must match an existing data type name exactly (case-sensitive).
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 3 Project Bubble actions on Nagent: "Get Record By ID", "Data API Get Data Type Fields" and "Data API Get Objects". Get Record By ID: Retrieves a single record by its unique ID from a specified data type (table/collection). Each action is listed on this page with its input parameters and its output.
Project Bubble 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.
Get Record By ID takes 2 required inputs: id and type. It returns data, error and successful.