Actions8
Scope
AI-generatedSummary
Fetches the Alephant scope for the configured virtual key by sending a GET request to the Alephant SaaS cockpit scope endpoint. It returns the API's JSON response as-is.
Inputs
- Operation (required) — Set to "Scope" (value
scope). This is the only setting that applies. Period, Limit, Offset, Request Log ID and Workspace ID are hidden for this operation and ignored. - Credentials (alephantVirtualKeyApi) (required) — The virtual key is sent as a Bearer token. The SaaS base URL defaults to https://alephant.io if the credentials don't set one.
Output shape
One output item per input item. Its json is the raw response from GET /api/v1/cockpit/scope, and each item is paired to its input item.
The response schema isn't defined in the node source. Other operations (such as Request Log Detail) read the workspace ID from this response, checking fields like workspaceId, workspace_id, and workspace.id. Transient network errors are retried once. HTTP errors are raised as NodeApiError. In AI tool mode, the result is returned as a JSON string.
Examples
Example 1: Check which workspace and scope a virtual key has access to before running analytics queries.
Operation: Scope, with Alephant Virtual Key credentials. No other parameters.
Example 2: Let an AI agent discover the key's scope as a tool call.
Attach the node to an AI Agent as a tool. The model sends operation: "scope" in its tool input.