Actions8
Usage Summary
AI-generatedSummary
Fetches aggregated Alephant AI usage statistics (the cockpit usage summary) for a chosen time period using the configured virtual key credential.
Inputs
- period — Time window for the summary: 24h, 7d, 30d, or 90d. Defaults to 7d. Sent as the
periodquery parameter. The 'filled by AI' option is the 7d default placeholder for AI tool mode, where the model supplies the value.
Output shape
One output item per input item, with the JSON response from Alephant's GET /api/v1/cockpit/usage-summary endpoint as its json (paired to the input item).
The response fields are defined by the Alephant API and are not declared in the node source. Authentication uses the alephantVirtualKeyApi credential as a Bearer token, against the credential's SaaS base URL (default https://alephant.io). A transient network error is retried once, and failures raise a NodeApiError. In AI tool mode, the result is returned to the agent as a JSON string.
Examples
Example 1: Report last month's AI usage in a scheduled workflow
Operation: Usage Summary; Period: 30 Days; credential: Alephant virtual key
Example 2: Let an AI agent answer questions about recent usage
Attach the node as a tool to an AI Agent. The model picks operation usageSummary and a period such as 24h.