Register Agent
AI-generatedSummary
Register a new agent identity in Vorim by sending a name and a list of permission scopes to the Vorim REST API (POST /v1/agents). Runs once per input item.
Inputs
- Name — Name of the agent to create. Sent as
name. The UI doesn't mark it required, but you should set it. Defaults to an empty string. - Scopes (comma-separated) — Comma-separated scopes to grant the agent, for example
agent:read,agent:write. The node splits on commas, trims whitespace and drops empty entries. Defaults toagent:read. The field is free text, so no scope values are validated in the node.
Output shape
One output item per input item. Its JSON is the API response's data object (the created agent record), or the whole response if there is no data wrapper. Each item is paired to its input item.
The exact fields of the agent record, such as the agent ID, come from the Vorim API and aren't defined in the node. Requests authenticate with the vorimApi credential (API key as Bearer token). The base URL defaults to https://api.vorim.ai unless the credential overrides it. An API error makes the node fail, because no continue-on-fail handling is coded in the node.
Examples
Example 1: Create a read-only agent identity for a new workflow.
Name: support-bot; Scopes: agent:read
Example 2: Register an agent that can read, write and execute, then use its returned ID in later Check Permission steps.
Name: invoice-processor; Scopes: agent:read, agent:write, agent:execute