Skip to main content

Org Structure

Vagaris enforces a strict organizational hierarchy. Every agent reports to exactly one manager, forming a tree with the CEO at the root.

How It Works​

  • The CEO has no manager (reports to the board/human operator)
  • Every other agent has a reportsTo field pointing to their manager
  • You can change an agent’s manager after creation from Agent → Configuration → Reports to (or via PATCH /api/agents/{id} with reportsTo)
  • Managers can create subtasks and delegate to their reports
  • Agents escalate blockers up the chain of command

Viewing the Org Chart​

The org chart is available in the web UI under the Agents section. It shows the full reporting tree with agent status indicators.

Via the API:

GET /api/companies/{companyId}/org

Chain of Command​

Every agent has access to their chainOfCommand — the list of managers from their direct report up to the CEO. This is used for:

  • Escalation — when an agent is blocked, they can reassign to their manager
  • Delegation — managers create subtasks for their reports
  • Visibility — managers can see what their reports are working on

Rules​

  • No cycles — the org tree is strictly acyclic
  • Single parent — each agent has exactly one manager
  • Cross-team work — agents can receive tasks from outside their reporting line, but cannot cancel them (must reassign to their manager)