Ninox connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Ninox actions, such as "Get Databases", "Get Team" and "List Teams". 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 Ninox, with input parameters and output schema.
NINOX_DELETE_RECORDTool to delete a record from a specified table. Use after confirming workspace, database, table, and record IDs.
Input parameters
Workspace (team) identifier. Obtain from GET /teams endpoint.
Table identifier. Ninox tables are identified by letters starting with A, B, C, etc. Obtain from GET /teams/{team_id}/databases/{database_id}/tables endpoint.
Record identifier to delete. Typically numeric. Obtain from GET /teams/{team_id}/databases/{database_id}/tables/{table_id}/records endpoint.
Database identifier. Obtain from GET /teams/{team_id}/databases endpoint.
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
NINOX_GET_DATABASESRetrieves all databases within a specific Ninox team. This action lists all databases (workspaces) that belong to a given team in Ninox. Each database contains tables, fields, and records for organizing data. Use this action when you need to: - List all available databases in a team - Find a specific database by name - Get database IDs for further operations Note: You must have a valid team_id. Use the GET /teams endpoint to retrieve team IDs first.
Input parameters
The unique identifier of the Ninox team to list databases for.
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
NINOX_GET_TEAMRetrieves data from a single team (workspace) by its ID. Use when you need to get workspace details including the workspace ID and name.
Input parameters
The unique identifier of the Ninox team/workspace to retrieve.
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
NINOX_LIST_TEAMSRetrieves all workspaces (teams) accessible to the authenticated user. This action lists all Ninox teams (workspaces) that the user has access to. Each team contains databases, which in turn contain tables and records. Use this action when you need to: - List all available workspaces - Find a specific workspace by name - Get workspace IDs for further operations (databases, tables, records) Note: The team_id from this response is required for most other Ninox API 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
Agents can call 4 Ninox actions on Nagent, including "Get Databases", "Get Team" and "List Teams". Get Databases: Retrieves all databases within a specific Ninox team. Each action is listed on this page with its input parameters and its output.
Ninox 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 Databases takes 1 required input: team_id. It returns data, error and successful.