NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Amcards connects to a Nagent workspace with an API key. Once it is connected, agents can call 10 Amcards actions, such as "Get API Schema", "Get Cards" and "Get Category". 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 Amcards, with input parameters and output schema.
AMCARDS_GET_API_SCHEMATool to retrieve the entire schema for AMCards API V1. Use when you need to discover available API endpoints, resources, and their structure.
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
AMCARDS_GET_CARDSThis tool retrieves a list of all cards associated with the authenticated account. The action is completely independent and doesn't require any external resource IDs or parameters beyond authentication. It allows users to monitor, track, and manage their cards.
Input parameters
The number of cards to skip before starting to collect the result set
The maximum number of cards to retrieve 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
AMCARDS_GET_CATEGORYTool to retrieve details of a specific category by ID. Use when you need to fetch information about a card template category including its title, hierarchy, and priority.
Input parameters
The unique identifier of the category 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
AMCARDS_GET_CATEGORY_SCHEMATool to retrieve the schema for Category resource. Categories are readonly. Use when you need to understand the structure and available fields of the Category resource.
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
AMCARDS_GET_CONTACTSThis tool retrieves a list of contacts from AMCards. It is used for managing contacts by providing details like limit, skip, and filters (e.g., last_name, first_name, email). The tool returns an array of contact objects containing fields such as id, first_name, last_name, email, created_at, and updated_at.
Input parameters
The number of contacts to skip before starting to collect the result set
Filter contacts by email address
The maximum number of contacts to retrieve
Filter contacts by last name
Filter contacts by first name
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
AMCARDS_GET_GIFTTool to retrieve details of a specific gift by ID. Use when you need to fetch information about a particular gift including its name, description, price, shipping cost, and availability.
Input parameters
The unique identifier of the gift 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
AMCARDS_GET_PUBLIC_TEMPLATETool to retrieve details of a specific public template by ID. Use when you need to get information about a specific template including its configuration, panels, and metadata.
Input parameters
The unique identifier of the public template 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
AMCARDS_LIST_CATEGORIESTool to retrieve a list of card template categories from AMCards. Categories are returned ordered by their priority (1 is highest). Use when you need to browse available categories, filter by parent category, or search categories by title.
Input parameters
Filter sub-categories by parent category ID. Use this to get only categories that belong to a specific parent category
Filter by category title (case-insensitive). Use this to search for categories containing specific text in their title
Filter by parent category title (case-insensitive). Use this to find categories whose parent's title contains specific text
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
AMCARDS_LIST_GIFTSTool to retrieve a list of Gift items offered by AMcards. Use when you need to display or reference available gifts for selection or purchase. No authorization required.
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
AMCARDS_LIST_PUBLIC_TEMPLATESTool to retrieve a list of public templates available to all users. Use when you need to browse or search available card templates. No authorization required for this endpoint.
Input parameters
Filter by category ID to retrieve templates from a specific category
Filter by template name (case-insensitive partial match). Use this to search for templates containing specific text in their name
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 10 Amcards actions on Nagent, including "Get API Schema", "Get Cards" and "Get Category". Get API Schema: Retrieve the entire schema for AMCards API V1. Each action is listed on this page with its input parameters and its output.
Amcards 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.