NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Certifier connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 Certifier actions, such as "List Attributes", "List Credential Interactions" and "List Credentials". 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 Certifier, with input parameters and output schema.
CERTIFIER_CREATE_ISSUE_SEND_CREDENTIALTool to create, issue, and send a credential in a single request. Use when group ID and recipient details are ready.
Input parameters
The unique identifier of the group to which the credential belongs.
ISO 8601 date string when the credential is issued (YYYY-MM-DD).
Recipient details: name and email.
ISO 8601 date string when the credential expires (YYYY-MM-DD).
Key-value map of custom attributes (tag → text value).
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
CERTIFIER_LIST_ATTRIBUTESTool to list all attributes available for credentials. Use when you need to retrieve attribute definitions with pagination.
Input parameters
Maximum number of attributes to return. Defaults to 20. Must be between 1 and 100.
Cursor from a previous response to fetch the next 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
CERTIFIER_LIST_CREDENTIAL_INTERACTIONSTool to list credential interactions. Use when you need to retrieve interaction events for a specific credential, with optional filtering and pagination.
Input parameters
Maximum number of interactions to return. Defaults to 20.
Cursor from previous response to fetch subsequent pages.
Filter interactions by this credential's 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
CERTIFIER_LIST_CREDENTIALSTool to list credentials. Use after authentication to retrieve paginated credentials.
Input parameters
Maximum number of credentials to return. Defaults to 20.
Cursor from previous response to fetch subsequent pages.
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
CERTIFIER_LIST_DESIGNSTool to list all designs. Use after authentication to retrieve certificate and badge designs with pagination.
Input parameters
Maximum number of designs to return. Defaults to 20. Must be between 1 and 100.
Cursor from a previous response to fetch the next 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
CERTIFIER_LIST_EMAIL_TEMPLATESTool to list all email templates available for credential delivery. Use when you need to retrieve available email templates for sending credentials.
Input parameters
Maximum number of email templates to return. Defaults to 20.
Cursor from previous response to fetch subsequent pages.
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
CERTIFIER_LIST_GROUPSTool to list all groups. Use when you need to retrieve groups with pagination (limit and cursor).
Input parameters
Maximum number of groups to return. Defaults to 20. Must be between 1 and 100.
Cursor from a previous response to fetch the next 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
CERTIFIER_SEARCH_CREDENTIALSTool to search for credentials using advanced filters and criteria. Use when you need to find specific credentials based on status, recipient, dates, or other properties. Supports complex queries with logical operators (AND, OR, NOT).
Input parameters
Sort configuration for search results.
Maximum number of results per page. Defaults to 20 if not specified.
Navigation token for pagination. Use the cursor from previous response to fetch next page.
Complex query object using logical operators (AND, OR, NOT) to filter credentials. Structure: {'AND': \[conditions\]} or {'OR': \[conditions\]} or {'NOT': condition}. Operators can be nested. Use empty AND array {'AND': \[\]} to match all records. Searchable fields: id, publicId, groupId, status, recipientId, recipient.name, recipient.email, issueDate, expiryDate, createdAt, updatedAt. String fields support: equals, contains, startsWith, endsWith, in. Date/DateTime fields support: equals, lt, lte, gt, gte. Example: {'AND': \[{'status': {'equals': 'issued'}}, {'recipient': {'email': {'endsWith': '@example.com'}}}\]}
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
CERTIFIER_SEND_CREDENTIALTool to send a published credential via email. Use after confirming the credential is published.
Input parameters
The unique identifier of the credential to send.
Delivery method; only 'email' is supported.
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 Certifier actions on Nagent, including "List Attributes", "List Credential Interactions" and "List Credentials". List Attributes: List all attributes available for credentials. Each action is listed on this page with its input parameters and its output.
Certifier 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 2 optional inputs: limit and cursor. It returns data, error and successful.