Currents API connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Currents API actions, such as "List Latest News", "Get Entity Usage Reports" and "List Users". 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 Currents API, with input parameters and output schema.
CURRENTS_API_ACTIVITIES_LISTTool to retrieve the latest news articles from Currents News API. Use when you need a real-time feed of recent articles.
Input parameters
Filter news by language (e.g., 'en', 'es', 'fr'). Defaults to English if omitted.
Number of articles per page (1-300). Defaults to 30 if omitted.
Page number for pagination (1-180). Defaults to 1 if omitted.
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
CURRENTS_API_ACTIVITIES_WATCHStart a push notification channel to watch user activities for Google Workspace applications. This action sets up a webhook to receive real-time notifications when activities occur in Google Workspace apps (admin, calendar, drive, docs, gmail, meet, etc.). Prerequisites: - Valid webhook URL that can receive POST notifications - OAuth credentials with appropriate scopes for the target application - For production use, requires Google Admin Reports API access Use this when you need to monitor user activities in real-time rather than polling.
Input parameters
Notification channel configuration including webhook URL, channel ID, and optional parameters
User identifier: use 'all' for all domain users, or specify a user's primary email address or unique user ID
Google Workspace application to monitor (e.g., 'admin' for admin console, 'drive' for Google Drive, 'calendar' for Google Calendar)
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
CURRENTS_API_ENTITY_USAGE_REPORTS_GETTool to retrieve usage statistics for a specific Google Workspace entity. Use when you need to analyze entity usage on a particular date.
Input parameters
Date of usage in ISO-8601 format (YYYY-MM-DD).
Comma-separated list of filters \[app\]:\[param\]\[operator\]\[value\], numeric parameters only; operators: ==, <>, <, <=, >, >=.
Object key to filter by; use 'all' to include all entities.
Token for fetching the next page of results.
Customer ID to retrieve data for.
Type of entity for the report; only 'gplus_communities' is supported.
Maximum number of results to return per page.
Comma-separated list of application parameters to include, e.g. 'gplus:numCommunitiesCreated'.
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
CURRENTS_API_USERS_LISTTool to list users in a Google Workspace domain. Note: - When the provided base_url points to Currents News API (api.currentsapi.services), this action will gracefully fall back to listing latest news articles to ensure a valid response, since the Currents News API does not expose a users endpoint. - When the base_url points to Google Admin Directory API, it will list users from the domain/customer specified.
Input parameters
Query string for searching user fields.
Domain name to list users from. Provide either `customer` or `domain`.
Property to sort results by.
Customer ID (e.g., 'my_customer'). Provide either `customer` or `domain`.
View type: 'admin_view' (admin only) or 'domain_public'.
Token for fetching the next page of results.
Sort direction.
Maximum number of results to return.
Subset of user fields to include in the response.
Whether to include deleted users. Defaults to false.
Comma-separated schema names; required only when `projection` is 'CUSTOM'.
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
CURRENTS_API_USER_USAGE_REPORT_GETRetrieve news articles from Currents News API with flexible search and filtering. Use this tool to: - Search for news articles by keywords or phrases - Filter articles by language, category, country, or date range - Retrieve paginated results for large result sets - Access comprehensive news data including titles, descriptions, authors, and publication dates This tool provides access to real-time global news content for information gathering, research, monitoring, or content curation purposes.
Input parameters
Filter by country code (e.g., 'US', 'GB', 'CA'). Returns news from the specified country.
Filter by news category (e.g., 'business', 'technology', 'sports', 'entertainment', 'politics'). Use comma-separated values for multiple categories.
End date for news articles in RFC 3339 format (e.g., '2026-01-28T23:59:59Z'). Returns articles published on or before this date.
Keywords or phrases to search for in news articles (e.g., 'technology', 'climate change'). Separate multiple keywords with spaces or commas.
Filter news by language code (e.g., 'en' for English, 'es' for Spanish, 'fr' for French). Defaults to English if omitted.
Number of articles per page (1-200). Defaults to the API's default page size if not specified.
Start date for news articles in RFC 3339 format (e.g., '2026-01-20T00:00:00Z'). Returns articles published on or after this date.
Page number for pagination. Defaults to 1 if not specified.
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 5 Currents API actions on Nagent, including "List Latest News", "Get Entity Usage Reports" and "List Users". List Latest News: Retrieve the latest news articles from Currents News API. Each action is listed on this page with its input parameters and its output.
Currents API 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: language, page_size and page_number. It returns data, error and successful.