NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Feathery connects to a Nagent workspace with an API key. Once it is connected, agents can call 19 Feathery actions, such as "Get Account Info", "List Document Envelopes" and "Create hidden field". 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 Feathery, with input parameters and output schema.
FEATHERY_ACCOUNT_EDITTool to edit an existing account’s role and permissions. Use when modifying account settings after confirming identity.
Input parameters
New role for the account.
The email of the account to edit. Required if account_id is not provided.
The UUID of the account to edit. Required if email is not provided.
Allow editing custom logic rules.
Allow editing form themes.
Allow editing form results.
Allow inviting form collaborators.
Allow editing collaborator settings.
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
FEATHERY_ACCOUNT_GET_INFOTool to get your Feathery team name and list of accounts. Use when you need to fetch your team's account info.
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
FEATHERY_DOCUMENT_FILL_TEMPLATETool to fill or sign a Feathery document template. Use when you need to generate a completed or signed document file after mapping template fields.
Input parameters
Associate an existing Feathery user with the generated document.
UUID of the document template to fill.
Mapping of field IDs to values to populate in the document.
Email address to route the filled document for signature.
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
FEATHERY_DOCUMENT_LIST_ENVELOPESTool to list generated document envelopes by document or user ID. Use when you need to retrieve envelope records for auditing or tracking.
Input parameters
Document ID when type='document'; User ID when type='user'.
Lookup mode: 'document' to list envelopes by document ID; 'user' to list envelopes by user 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
FEATHERY_FORM_CREATE_HIDDEN_FIELDCreates a new hidden field in the Feathery account. Hidden fields store non-visible data that can be populated via integrations, the API, embed SDK, or URL parameters. Use this to track metadata like UTM parameters, user IDs, or integration data. The field_id must be unique - use FEATHERY_FORM_LIST_HIDDEN_FIELDS first to check existing fields if unsure.
Input parameters
A unique identifier for the new hidden field. Must not already exist in the account. Returns a 400 error if the field_id already exists.
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
FEATHERY_FORM_DELETEPermanently delete a form from your Feathery account. This action is irreversible. Use the 'List Forms' action first to get valid form IDs. The form_id corresponds to the 'id' field in the form list response.
Input parameters
The unique identifier of the form to delete. Get this from the 'List Forms' action.
Safety confirmation flag. Must be set to true to proceed with deletion.
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
FEATHERY_FORM_GET_SCHEMARetrieve the complete schema of a Feathery form including all steps, fields, rules, and translations. Use the List Forms action first to find the form_id. Returns detailed structure for understanding or manipulating form content.
Input parameters
The unique identifier of the Feathery form to retrieve. You can obtain this ID from the List Forms 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
FEATHERY_FORM_LISTTool to list all forms in your Feathery account. Use when you need to view or filter available forms.
Input parameters
Only return forms that have all of these tags.
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
FEATHERY_FORM_LIST_HIDDEN_FIELDSTool to list all hidden form fields in the account. Use when you need to retrieve hidden field configuration before processing form submissions.
Input parameters
Maximum number of hidden fields to return. If not provided, all results are returned.
Number of hidden fields to skip before returning results. Use with limit for pagination.
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
FEATHERY_LOG_LIST_API_CONNECTOR_ERRORSTool to list recent API connector error logs for a form. Use after confirming the form ID to troubleshoot integration issues.
Input parameters
ID of the form to retrieve error logs for.
Only return errors before this ISO8601 timestamp.
Only return errors after this ISO8601 timestamp.
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
FEATHERY_LOG_LIST_EMAIL_ISSUESTool to list email bounce and complaint events. Use when you need to diagnose delivery issues for sent emails.
Input parameters
Only return events occurring before this ISO 8601 timestamp.
Filter by event type. If omitted, returns both bounce and complaint events.
Only return events occurring at or after this ISO 8601 timestamp.
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
FEATHERY_LOG_LIST_EMAILSTool to list recently sent emails for a form. Use when you need to review email logs after sending form-based emails.
Input parameters
ID of the form to list email logs for
Only return emails sent before this time
Only return emails sent after this time
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
FEATHERY_LOG_LIST_QUICK_REQUESTSTool to list recent Quik integration request logs for a form. Use when you need to review API requests sent to Quik for a specific form.
Input parameters
ID of the form whose Quik logs to retrieve
Only return requests made before this time (ISO 8601 format)
Only return requests made after this time (ISO 8601 format)
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
FEATHERY_USER_CREATE_OR_FETCHTool to create a new user or fetch an existing one. Use when you need to ensure a user exists and get their SDK key.
Input parameters
Your unique user 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
FEATHERY_USER_DELETETool to delete a specific user by ID. Use when you need to remove a user after confirming the user exists.
Input parameters
Unique identifier of the user 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
FEATHERY_USER_GET_ALL_DATARetrieve all stored data fields for a user or all field definitions in your Feathery account. Use this to fetch form field values submitted by users, or to list all available field definitions. Returns field metadata including type, value, timestamps, and whether it's a hidden field.
Input parameters
User ID to filter fields for a specific user. If omitted, returns all field definitions 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
FEATHERY_USER_GET_SESSIONTool to get a user's form session and progress. Use after authenticating and when you need to retrieve session data.
Input parameters
Unique user identifier to fetch session 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
FEATHERY_USER_LISTTool to list all users in your Feathery account. Use when you need to retrieve users with optional creation time or field-based filters.
Input parameters
ISO 8601 datetime to filter users created on or after this timestamp.
ISO 8601 datetime to filter users created on or before this timestamp.
ID of a form field or hidden field to filter users by. Use with filter_field_value to find users that have a specific value for that field.
Value to match for the specified filter_field_id. Required when filter_field_id is 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
FEATHERY_WORKSPACE_GENERATE_LOGIN_TOKENGenerate a login JWT for a Feathery workspace. This is used for white-label integrations where users authenticate through your system and are automatically logged into Feathery. Prerequisites: - Obtain workspace_id from the list workspaces API or workspace creation - Obtain account_id from the 'Get Account Info' action The token is valid for 24 hours and can be refreshed by calling this endpoint again. Note: Returns empty token if workspaces feature is not enabled for the account.
Input parameters
Unique identifier (UUID) of the account to authenticate. Obtain from the 'Get Account Info' action which returns account IDs.
Unique identifier (UUID) of the workspace. Obtain from the list workspaces endpoint or workspace creation response.
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 19 Feathery actions on Nagent, including "Get Account Info", "List Document Envelopes" and "Create hidden field". Get Account Info: Get your Feathery team name and list of accounts. Each action is listed on this page with its input parameters and its output.
Feathery 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.