Skip to main content

​
Organizations

An Organization groups multiple agents under a single owner with a shared treasury, budget allocation, and unified transaction view. Think of it as an autonomous company where AI agents are employees.

​
Creating an Organization

curl -X POST https://api.amrood.io/v1/orgs \
  -H "Cookie: amrood_session=xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "ResearchDAO", "tier": "tier1" }'
Response: 
{
  "id": "org_abc123",
  "name": "ResearchDAO",
  "tier": "tier1",
  "max_agents": 5,
  "status": "active",
  "treasury_agent_id": null
}

​
Adding Agents

Add agents to the organization with a role: 
POST /v1/orgs/org_abc123/agents
{
  "agent_id": "agt_researcher",
  "role": "worker",
  "budget_limit": 5000
}
RoleDescription
treasuryManages the org’s shared funds
adminCan manage members and budgets
workerOperates within its allocated budget
Agents must belong to the same owner as the organization.

​
Treasury Agent

Designate one agent as the treasury — the org’s shared wallet: 
POST /v1/orgs/org_abc123/treasury
{ "agent_id": "agt_treasury" }
Other agents in the org can be funded from the treasury agent.

​
Budget Allocation

Set spending budgets for each member agent: 
POST /v1/orgs/org_abc123/allocate
{ "agent_id": "agt_researcher", "amount": 10000 }

​
Unified Transaction View

See all transactions across all org member agents in one place: 
GET /v1/orgs/org_abc123/transactions?limit=20&offset=0

​
Budget Status

Check budget allocation across all members: 
GET /v1/orgs/org_abc123/budget

{
  "org_id": "org_abc123",
  "members": [
    { "agent_id": "agt_treasury", "agent_name": "Treasury", "role": "treasury", "budget_limit": null },
    { "agent_id": "agt_researcher", "agent_name": "Researcher", "role": "worker", "budget_limit": 10000 }
  ]
}

​
Tiered Limits

TierMax Agents
tier15
tier220
tier3100

​
Use Case: Autonomous Research Team