NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Remote Retrieval connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Remote Retrieval actions, such as "Create Order", "Get All Orders" and "Get Company Details". 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 Remote Retrieval, with input parameters and output schema.
REMOTE_RETRIEVAL_CREATE_ORDERTool to create IT asset retrieval orders for remote employees. Use when you need to schedule pickup of laptops, monitors, cell phones, or tablets from employees. Supports both return-to-company and recycle-with-data-destruction workflows.
Input parameters
List of order items to create. Can create single or multiple orders in one request
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
REMOTE_RETRIEVAL_GET_ALL_ORDERSTool to retrieve a paginated list of all orders. Use when you need to list orders with optional filters like status or dates. Call after authentication.
Input parameters
Page number for pagination (must be ≥ 1).
Filter orders by status, e.g., 'pending' or 'completed'.
ISO 8601 end date for filtering orders, e.g., '2023-01-31T23:59:59Z'.
Number of orders per page (1–100).
ISO 8601 start date for filtering orders, e.g., '2023-01-01T00:00:00Z'.
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
REMOTE_RETRIEVAL_GET_COMPANY_DETAILSTool to retrieve detailed information for a company. Use after confirming a valid company_id.
Input parameters
Unique identifier for the company
Whether to include company contact details
Filter results by industry category
Whether to include financial data
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
REMOTE_RETRIEVAL_GET_DEVICE_PRICESTool to retrieve real-time pricing data for all supported devices. Use when you need current prices for Laptop, Monitor (17-23 inch), Monitor_27 (24-27 inch), Tablet, or Cell Phone.
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
REMOTE_RETRIEVAL_GET_ORDER_DETAILSTool to retrieve specific order details by order ID. Use when you need detailed information about an order including employee info, company info, and shipment status (device_type, send_status, return_status).
Input parameters
Order ID to retrieve details 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
REMOTE_RETRIEVAL_LIST_PENDING_ORDERSTool to retrieve list of all pending orders. Use when you need to check orders awaiting payment completion. Results are paginated up to 25 per page.
Input parameters
Page number for pagination. Results are paginated up to 25 per page.
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
REMOTE_RETRIEVAL_VALIDATE_USERTool to validate the provided API key. Use when you need to confirm the API key's validity.
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 Remote Retrieval actions on Nagent, including "Create Order", "Get All Orders" and "Get Company Details". Create Order: Create IT asset retrieval orders for remote employees. Each action is listed on this page with its input parameters and its output.
Remote Retrieval 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 Order takes 1 required input: orders. It returns data, error and successful.