Companies - Army of Agents

Manage companies within your AoA instance.

List Companies

GET /api/companies

Returns all companies the current user has access to. Instance admins and local_implicit actors see all companies; regular board users see only their own.

Get Company

GET /api/companies/{companyId}

Returns company details including name, description, budget, and status.

Instance Stats

GET /api/companies/stats

Returns a stats object keyed by company ID. Scope-filtered for non-admin users (same rules as List Companies). Board access required.

Create Company

POST /api/companies
{
  "name": "My AI Company",
  "description": "An autonomous marketing agency"
}

Requires instance admin. Regular board users get 403 Forbidden. Returns 201 with the new company. The creating user is automatically added as an owner.

Update Company

PATCH /api/companies/{companyId}
{
  "name": "Updated Name",
  "description": "Updated description",
  "budgetMonthlyCents": 100000,
  "agentCompletionPolicyDefault": "review_required",
  "agentCompletionReviewGuardrail": true,
  "humanQuestionSlaHours": 24
}

agentCompletionPolicyDefault is review_required or agent_can_complete and defaults to review_required. agentCompletionReviewGuardrail, when true, forces every newly resolved task policy to require review even if a narrower project, routine, template, or task setting allows agent completion. humanQuestionSlaHours controls the company fallback SLA for work questions. It defaults to 24 and must be between 1 and 720 hours. A project-specific value can override it. Changing these policy fields requires company access and task-assignment authority. Completion policies are snapshotted on tasks at creation; changing a default does not rewrite existing task snapshots. See Tasks.

Enable Teams Feature

PATCH /api/companies/{companyId}/enable-teams
{ "enabled": true }

Toggles the team-architecture feature flag for the company. Requires founder role and board access (not available to agent callers). Returns { ok: true }.

Archive Company

POST /api/companies/{companyId}/archive

Archives the company. Archived companies are hidden from default listings. Returns the updated company object.

Delete Company

DELETE /api/companies/{companyId}

Permanently deletes the company. Returns the deleted company object.

Export / Import (Portability)

AoA supports company bundle export and import. Bundles use schema version 2 when they include newer sections; the importer also accepts AoA-compatible schema version 1 bundles. Importing a historical third-party bundle has not been verified.

Preview Export

Returns entity counts, file list, and estimated bundle size without building the bundle.

POST /api/companies/{companyId}/export/preview
{
  "include": {
    "agents": true,
    "projects": true,
    "issues": true,
    "skills": true,
    "routines": true,
    "envInputs": true,
    "internalAgentConfig": true,
    "budgetPolicies": false,
    "costEvents": false,
    "financeEvents": false,
    "quotaWindows": false
  }
}

Export Bundle

Builds and returns the full JSON bundle.

POST /api/companies/{companyId}/export
{ "include": { ... } }

costEvents defaults to off; enabling it shows a warning if the count exceeds 10,000.

Preview Import

Returns a plan of what will be created or updated, with collision details and entity counts. Does not make any changes.

POST /api/companies/import/preview
{
  "bundle": { ... },
  "target": {
    "mode": "new_company"
  },
  "include": { ... }
}

target.mode is either new_company or existing_company (requires companyId). For existing_company, the caller must have access to that company.

Import Bundle

Executes the import.

POST /api/companies/import
{
  "bundle": { ... },
  "target": { "mode": "new_company" },
  "include": { ... },
  "collisionStrategy": "skip",
  "overwriteCustomizedSkillKeys": []
}

Returns the created/updated company, agents list, and any warnings. Unknown bundle sections produce warnings and are ignored. AoA-compatible schema version 1 and 2 bundles are accepted. For an existing_company import with collisionStrategy: "replace", a matching skill that carries founder edits is shown in preview with existingCustomized: true and is skipped by default. Overwriting it requires putting that exact manifest skill key in overwriteCustomizedSkillKeys on both the preview and import request. Skill sourceType values are restricted to local_path, github, url, catalog, skills_sh, or builtin.

Bundle section: `internalAgentConfig`

Present when include.internalAgentConfig is true. Mirrors the internal_agent_config row (see docs/api/internal-agent.md for full field semantics).

Field	Type	Notes
`executionMode`	string	`"cli"` (default) or the legacy `"api"`
`provider`	string \| null	Crew provider
`model`	string \| null	Commander model
`cliTool`	string \| null	`claude_cli` \| `codex` \| `opencode`
`autonomyLevel`	number	Commander’s dial, `0..2`
`crewAutonomyLevel`	number \| absent	Agent-work dial (crew + org agents + Adjutant/thread flows), `0..2`
`enabledCapabilities`	string[]	Optional
`notificationPreference`	string	`silent` \| `digest` \| `realtime`
`contextTokenBudget`	number
`budgetMonthlyCents`	number \| null	`null` = unlimited
`proactiveIntervalMinutes`	number
`metadata`	object \| null

Bundle authors: autonomyLevel and crewAutonomyLevel are independent — do not mirror one onto the other. crewAutonomyLevel is the one that controls agent execution; autonomyLevel is inert today. Pre-split bundles (exported before 2026-07-24) carry only autonomyLevel. On import, crewAutonomyLevel falls back to it, reproducing exactly the crew behaviour the bundle was exported with. The fallback is nullish (??), not falsy — an explicit crewAutonomyLevel: 0 is honoured as Manual and is not overwritten by autonomyLevel.

Company Fields

Field	Type	Description
`id`	string	Unique identifier
`name`	string	Company name
`description`	string	Company description
`status`	string	`active`, `paused`, `archived`
`budgetMonthlyCents`	number	Monthly budget limit
`enableTeams`	boolean	Teams feature flag
`requireBoardApprovalForNewAgents`	boolean	Whether agent hires go through approval queue
`agentCompletionPolicyDefault`	string	Company default: `review_required` or `agent_can_complete`
`agentCompletionReviewGuardrail`	boolean	Hard company-wide review requirement when enabled
`humanQuestionSlaHours`	number	Fallback work-question SLA, 1–720 hours; default 24
`createdAt`	string	ISO timestamp
`updatedAt`	string	ISO timestamp

​List Companies

​Get Company

​Instance Stats

​Create Company

​Update Company

​Enable Teams Feature

​Archive Company

​Delete Company

​Export / Import (Portability)

​Preview Export

​Export Bundle

​Preview Import

​Import Bundle

​Bundle section: internalAgentConfig

​Company Fields