NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Curated connects to a Nagent workspace with an API key. Once it is connected, agents can call 6 Curated actions, such as "Create Draft Issue", "Create Collected Link" and "List Categories". 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 Curated, with input parameters and output schema.
CURATED_CREATE_DRAFT_ISSUETool to create a draft issue for a publication. Use after confirming the publication ID. Applies default settings if optional fields are omitted.
Input parameters
Title of the new draft issue
Optional note from the editor
Sequential number for the issue; if omitted, the next available number is used
The numeric ID of the publication where the draft issue will be created. Obtain this from the List Publications action.
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
CURATED_CREATE_LINKTool to create a collected link for a publication. Use when you want to add a new link (with URL, title, etc.) to a publication's collection.
Input parameters
URL for the collected link
Optional image URL for the collected link
Optional title of the collected link
Optional category for the collected link, e.g., 'code'
Optional description for the collected link
ID of the publication to which the link will be added
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
CURATED_LIST_CATEGORIESTool to list all categories for a publication. Use after you have the publication ID and need to fetch its categories.
Input parameters
The numeric ID of the publication (as a string) for which to retrieve categories. Use the 'List Publications' action first to get a list of available publication IDs.
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
CURATED_LIST_EMAIL_SUBSCRIBERSTool to list all email subscribers for a publication. Use after confirming the publication ID.
Input parameters
Page number of results to return. Starts at 1 (default: 1).
Number of subscribers per page. Valid range: 1-500 (default: 100).
The unique ID of the publication whose subscribers are being listed. Obtain this ID by calling the List Publications action first.
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
CURATED_LIST_ISSUESLists all issues (newsletters) for a Curated publication with pagination support. Use this tool to retrieve issues from a publication. You must first obtain the publication_id by calling the List Publications action. Supports filtering by state (published/draft) and optionally includes email performance stats (open/click rates).
Input parameters
Page number for pagination (1-indexed). Defaults to 1 if not specified.
Filter issues by state: 'published' returns only published issues, 'draft' returns only draft issues. If omitted, returns all issues.
If set to true, results will include open and click rates for issues.
Number of results per page. Defaults to 10, maximum is 250.
The numeric ID of the publication for which to list issues. Obtain this from the List Publications action.
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
CURATED_LIST_PUBLICATIONSTool to list all publications accessible by the API key. Use when you need to retrieve your publication IDs for further API calls. Example prompt: "List my publications".
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 6 Curated actions on Nagent, including "Create Draft Issue", "Create Collected Link" and "List Categories". Create Draft Issue: Create a draft issue for a publication. Each action is listed on this page with its input parameters and its output.
Curated 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 Draft Issue takes 2 required inputs: title and publication_id. It also takes 2 optional inputs: editor_note and issue_number. It returns data, error and successful.