NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Ragic connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Ragic actions, such as "Get Action Buttons", "Get Custom Print Report" and "Get Entry". 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 Ragic, with input parameters and output schema.
RAGIC_DELETE_ENTRYTool to delete an entry from a Ragic sheet. Use when you need to remove a specific record from a sheet by its record ID.
Input parameters
Ragic server subdomain (e.g., 'na5', 'www', 'ap5', 'eu2'). If provided, overrides the default server. Check your Ragic URL to find your server.
The record ID of the entry to delete.
The tab folder path for the sheet (e.g., 'ragic-setup' or 'sales').
The sheet index number.
Your Ragic account name (the subdirectory in your Ragic URL, e.g., 'composio' from 'https://na5.ragic.com/composio/...').
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
RAGIC_DOWNLOAD_FILETool to download uploaded files, images, or email attachments from Ragic. Use the file reference returned from API responses (e.g., from record fields).
Input parameters
Ragic server subdomain (e.g., 'na5', 'www', 'ap5', 'eu2'). If provided, overrides the default server. Check your Ragic URL to find your server.
Your Ragic account name (the subdirectory in your Ragic URL, e.g., 'composio' from 'https://na5.ragic.com/composio/...').
The file reference as returned from API responses (e.g., 'Ni92W2luv@My_Picture.jpg'). This is the encoded filename with hash prefix.
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
RAGIC_GET_ACTION_BUTTONSTool to retrieve the list of available action buttons on a Ragic sheet. Returns action button IDs and names. Use category=massOperation to get buttons available for mass operations.
Input parameters
Ragic server subdomain (e.g., 'na3', 'www', 'na5', 'ap5', 'eu2'). If provided, overrides the default server. Check your Ragic URL to find your server.
Filter action buttons by category. Use 'massOperation' to get buttons available for mass operations on multiple records. If not provided, may return HTTP 500 error on some sheets.
The tab folder path in the Ragic sheet structure.
The sheet index number identifying the specific sheet.
The Ragic account name (the subdirectory in your Ragic URL, e.g., 'RSDemo' from 'https://na3.ragic.com/RSDemo/...').
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
RAGIC_GET_CUSTOM_PRINT_REPORTTool to retrieve a custom print report for a Ragic record in various formats (pdf, png, docx). Use when you need to generate and download a formatted report using a specific template.
Input parameters
Ragic server subdomain (e.g., 'na5', 'www', 'ap5', 'eu2'). If provided, overrides the default server. Check your Ragic URL to find your server.
The ID of the record to retrieve the custom print report for.
Output format for the custom print report.
The tab folder path in your Ragic sheet URL.
The sheet index number from your Ragic sheet URL.
Your Ragic account name (the subdirectory in your Ragic URL, e.g., 'composio' from 'https://na5.ragic.com/composio/...').
Optional field ID to use as the filename for the downloaded report.
The custom print template ID to use for generating the report.
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
RAGIC_GET_ENTRYTool to retrieve a single entry from a Ragic sheet by its record ID. Use when you need to fetch specific record data including field values and optional subtable data.
Input parameters
API version (e.g., '3' or 'version=2025-01-01'). Recommended to use '3' for v3 API.
Set to True to add 'Create Date' and 'Create User' information to the response.
Ragic server subdomain (e.g., 'na5', 'www', 'ap5', 'eu2'). If provided, overrides the default server. Check your Ragic URL to find your server.
Set to True to add comment thread information related to this record to the response.
Set to True to add edit history related to this record to the response.
The record ID of the entry to retrieve.
Set to False to exclude subtable data from the response. If True or not provided, subtables are included by default.
The tab folder path for the sheet (e.g., 'ragic-setup', 'sales').
The sheet index number (e.g., 1, 2).
Your Ragic account name (the subdirectory in your Ragic URL, e.g., 'composio' from 'https://na5.ragic.com/composio/...').
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
RAGIC_GET_RECORD_AS_PDFTool to retrieve a PDF version of a Ragic record. Use when you need to export or download a record in PDF format. The PDF will contain the full record data in a formatted document.
Input parameters
Ragic server subdomain (e.g., 'na5', 'www', 'ap5', 'eu2'). If provided, overrides the default server. Check your Ragic URL to find your server.
The record ID to retrieve as PDF.
The tab folder path in your Ragic account.
The sheet index number (numeric identifier for the sheet).
Your Ragic account name (the subdirectory in your Ragic URL, e.g., 'composio' from 'https://na5.ragic.com/composio/...').
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
RAGIC_SEARCH_RECORDSSearch Records
Input parameters
Set to True to add 'Create Date', 'Create User' information to the response.
Maximum number of records to return. Ragic defaults to 100 if not specified.
Set to True to retrieve the raw BBCode value saved to the field instead of being translated to HTML.
The starting record index (0-based) for pagination. Use with 'limit' to page through results.
Ragic server subdomain (e.g., 'na5', 'www', 'ap5', 'eu2'). If provided, overrides the default server. Check your Ragic URL to find your server.
Set to True to add the comment thread related to this record to the response.
Set to True to add the edit history related to this record to the response.
Set to True to only include fields in the Listing Page.
Set to True to reverse the default ordering of the listing page response.
Set to True to add the approval information related to this record to the response.
Set to False to not include subtable information in the response. If True or not provided, subtables are included by default.
When True, the field value of 'Masked text' will be unmasked if you are in the viewable groups.
Path to the Ragic sheet in format 'tab_folder/sheet_index' (e.g., 'ragic-setup/1' or 'sales/2').
Your Ragic account name (the subdirectory in your Ragic URL, e.g., 'composio' from 'https://na5.ragic.com/composio/...').
Set to True to add the email conversation information related to this record to the response.
The full-text search query to find matching records.
When True, the fixed filter on this sheet will be ignored (requires SYSAdmin privilege).
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 7 Ragic actions on Nagent, including "Get Action Buttons", "Get Custom Print Report" and "Get Entry". Get Action Buttons: Retrieve the list of available action buttons on a Ragic sheet. Each action is listed on this page with its input parameters and its output.
Ragic 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 Action Buttons takes 3 required inputs: tab_folder, sheet_index and account_name. It also takes 2 optional inputs: server and category. It returns data, error and successful.