NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Niftyimages connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 Niftyimages actions, such as "Get Images Stats", "Get Widget User Images" and "Get Widget User Stats". 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 Niftyimages, with input parameters and output schema.
NIFTYIMAGES_GET_IMAGES_STATSTool to get aggregated stats for all images. Use when you need to retrieve statistical data and performance metrics for all images in the account.
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
NIFTYIMAGES_GET_WIDGET_USER_IMAGESTool to list widget images for a specific user. Use when you need to retrieve all images associated with a particular user and widget combination.
Input parameters
The user identifier to retrieve images for.
The unique identifier (key) of the widget. This is a UUID format identifier.
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
NIFTYIMAGES_GET_WIDGET_USER_STATSTool to get aggregated stats for a specific user on a widget. Use when you need to retrieve performance metrics for a particular user's interaction with a widget.
Input parameters
The user identifier for which to retrieve aggregated stats
The unique identifier (key) of the widget
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
NIFTYIMAGES_LIST_IMAGESTool to page through images in your NiftyImages account. Use when you need to retrieve a list of all available images.
Input parameters
Page number to retrieve (1-based). Defaults to the first page when not specified.
Number of images to return per page. Defaults to the API default when not specified.
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
NIFTYIMAGES_LIST_MAPSTool to retrieve all maps in your NiftyImages account. Use when you need to view all available maps for geo-targeting or location-based email content.
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
NIFTYIMAGES_LIST_WIDGET_IMAGESTool to list widget images for a time frame. Use when you need to retrieve images generated by a specific widget within an optional date range.
Input parameters
End date in ISO 8601 format (e.g., 2024-12-31T23:59:59Z). Filter images created on or before this date.
Start date in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Filter images created on or after this date.
The unique identifier (key) of the widget. This is a UUID format identifier.
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
NIFTYIMAGES_LIST_WIDGETSTool to list all widgets in your NiftyImages account. Use when you need to retrieve all available widgets.
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
NIFTYIMAGES_LIST_WIDGET_STATSTool to retrieve widget statistics for a specified time frame from NiftyImages. Use when you need to view performance metrics such as impressions and clicks for your widgets.
Input parameters
End date for the stats time frame in ISO 8601 format (e.g., 2016-03-10T08:00Z). If not provided, stats up to the current time will be included.
Start date for the stats time frame in ISO 8601 format (e.g., 2016-02-10T08:00Z). If not provided, stats from the beginning will be included.
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
NIFTYIMAGES_LIST_WIDGET_USERSTool to list widget users for a specified time frame from NiftyImages. Use when you need to retrieve users who interacted with a specific widget during a date range.
Input parameters
End date for the time frame in ISO 8601 format (e.g., 2026-02-13T23:59:59Z). If not specified, defaults to API's default end date.
Start date for the time frame in ISO 8601 format (e.g., 2026-01-01T00:00:00Z). If not specified, defaults to API's default start date.
The unique identifier (key) of the widget to retrieve users 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
Agents can call 9 Niftyimages actions on Nagent, including "Get Images Stats", "Get Widget User Images" and "Get Widget User Stats". Get Images Stats: Get aggregated stats for all images. Each action is listed on this page with its input parameters and its output.
Niftyimages 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.
It returns data, error and successful.