Humanitix connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Humanitix actions: "Get Event", "Get Events" and "Get Tags". 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 Humanitix, with input parameters and output schema.
HUMANITIX_GET_EVENTTool to retrieve detailed information about a specific event. Use when you have the eventId and need full metadata.
Input parameters
Unique identifier for the event.
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
HUMANITIX_GET_EVENTSTool to retrieve a paginated list of events from your Humanitix account. Use when you need to page through your events after confirming API key validity.
Input parameters
Page number you wish to fetch.
Results since this date-time (ISO 8601).
Page size of the results you wish to fetch.
If true, return only events that have an endDate in the future.
Override the user location; ISO 3166-1 alpha-2 country code.
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
HUMANITIX_GET_TAGSTool to get all tags associated with your Humanitix account. Use when you need to list or paginate through tags after setting up your API key.
Input parameters
Page number for paginated results, must be >=1
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 3 Humanitix actions on Nagent: "Get Event", "Get Events" and "Get Tags". Get Event: Retrieve detailed information about a specific event. Each action is listed on this page with its input parameters and its output.
Humanitix 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.
Get Event takes 1 required input: event_id. It returns data, error and successful.