NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Ritekit connects to a Nagent workspace with an API key. Once it is connected, agents can call 14 Ritekit actions, such as "Get Access Token", "Get Full Email Insights" and "List Link Ads". 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 Ritekit, with input parameters and output schema.
RITEKIT_AUTO_HASHTAGTool to automatically add relevant hashtags to a given post. Use when you have plain text and need suggested hashtags appended or inserted in context.
Input parameters
Text of the post to add hashtags to
Maximum number of hashtags to add (default is 2)
Position of hashtags: 'auto' to insert in context, 'end' to append at end (default is 'auto')
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
RITEKIT_BANNED_INSTAGRAM_HASHTAGSTool to identify which hashtags are banned on Instagram. Use when preparing content and need to filter out banned hashtags before posting.
Input parameters
List of hashtags to check (without the leading '#'), 1-100 items
RiteKit API client ID passed as 'client_id' query parameter (alternative to access_token)
RiteKit OAuth2 access token passed as 'access_token' query parameter
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
RITEKIT_DETECT_DISPOSABLE_EMAILTool to detect if an email address is disposable. Use when validating email addresses to filter out temporary or fake email services.
Input parameters
Email address to check for disposable status
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
RITEKIT_DETECT_EMAIL_TYPOTool to detect common typos in email addresses and suggest corrections. Use when validating email input to help users correct mistakes like gml.com -> gmail.com.
Input parameters
Email address to check for typos and get correction suggestions
Your RiteKit API client ID; must be passed as 'client_id' query parameter
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
RITEKIT_FREEMAIL_DETECTIONTool to detect whether an email address belongs to a free email provider. Use when validating lead quality before ingestion.
Input parameters
Email address to check for free-email provider
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
RITEKIT_GET_ACCESS_TOKENTool to obtain a RiteKit access token. Prefer using a stored token from connection metadata or request. Falls back to OAuth2 client credentials if both client_id and client_secret are provided and no token is otherwise available.
Input parameters
Optional RiteKit API client ID.
Optional access token. If provided, the action will return this token without making a network request.
Optional RiteKit API client secret.
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
RITEKIT_GET_CLIENT_IDTool to retrieve stored RiteKit client_id. Use when child actions require the client_id query parameter.
Input parameters
Optional RiteKit API client ID. If not provided, the action attempts to read from connection metadata using keys: 'client_id', 'clientId', or 'client-id'.
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
RITEKIT_GET_CLIENT_SECRETTool to retrieve stored RiteKit client_secret. Use when child actions require the client_secret parameter.
Input parameters
Optional RiteKit API client secret. If not provided, the action attempts to read from connection metadata using keys: 'client_secret', 'clientSecret', or 'client-secret'.
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
RITEKIT_GET_FULL_EMAIL_INSIGHTSTool to retrieve comprehensive email address insights including full name, free mail detection, business email detection, and typo suggestions. Use when you need detailed analysis of an email address for lead qualification or email validation.
Input parameters
Email address to analyze for detailed insights including full name, free mail detection, business email detection, and typo suggestions
RiteKit API client ID. If not provided, will be read from connection metadata
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
RITEKIT_HASHTAG_SUGGESTIONSTool to get hashtag suggestions for a given text. Use when you need relevant hashtags for social media posts.
Input parameters
Input text or single word (1–1000 characters) to get hashtag suggestions
Client ID for authentication; required if access_token is not provided
OAuth2 access token; required if client_id is not provided
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
RITEKIT_LINK_AD_DELETETool to delete a link ad. Use when you need to permanently remove a link ad by its ID.
Input parameters
Unique identifier of the link ad to delete
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
RITEKIT_LIST_LINK_ADSTool to retrieve a list of link ads. Use after authenticating to fetch all link ads for the user.
Input parameters
RiteKit API client ID; optional if using OAuth access_token
OAuth2 access token; optional if using client_id
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
RITEKIT_SHORTEN_LINKTool to shorten a URL with a specified CTA. Use when you need to generate a call-to-action-enabled short link.
Input parameters
ID of the call-to-action to attach to the shortened link
URL to be shortened
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
RITEKIT_TEXT_TO_IMAGETool to convert a quote into a styled image. Use after preparing quote text and style options.
Input parameters
Text of the quote to render as an image
Name of the author or source of the quote
Background type: 'solid' or 'gradient'
Font size for the quote text (px, between 8 and 144)
Animation effect: none, rays, glint, or circle
URL of a brand logo to include
Optional RiteKit API client ID. If not provided, the action attempts to read from connection metadata
Font family for the quote text
Font family for the author text
Gradient type when bgType is 'gradient'
Display quote mark (1 = yes, 0 = no)
First color for gradient background
Second color for gradient background
Color (hex or name) for highlight
Color (hex or name) for the quote text
Color (hex or name) for the author text
Background color for solid type
Highlight behind quote text (1 = yes, 0 = no)
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 14 Ritekit actions on Nagent, including "Get Access Token", "Get Full Email Insights" and "List Link Ads". Get Access Token: Obtain a RiteKit access token. Each action is listed on this page with its input parameters and its output.
Ritekit 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 also takes 3 optional inputs: client_id, access_token and client_secret. It returns data, error and successful.