Actions8
Budget Status
AI-generatedSummary
Fetches the budget status for the Alephant account tied to the virtual key credential, over a selected time period, via GET /api/v1/cockpit/budget-status on the Alephant SaaS host.
Inputs
- period — Time window for the budget query: 24h, 7d (default), 30d, or 90d. Sent as the
periodquery string parameter. In AI tool mode, the model can fill this in.
Output shape
One output item per input item, whose json is the raw response body from the Alephant budget-status endpoint. The item is paired with its input item. In AI tool mode, the same response is returned as a JSON string.
The source doesn't define the response fields, so they depend on the Alephant API. Requires the alephantVirtualKeyApi credential, sent as a Bearer token. If the credential has a workspace ID, it is sent as X-Workspace-Id. HTTP errors are raised as NodeApiError, and one retry is made for transient network errors such as ECONNRESET or ETIMEDOUT.
Examples
Example 1: Check how much AI budget has been used over the last 30 days before running an expensive workflow.
Operation: Budget Status; Period: 30 Days
Example 2: Let an AI agent answer questions like 'Are we near our budget today?'
Use the node as an AI tool; the model selects operation=budgetStatus and period=24h.