Agents, providers and usage
Where agents and providers appear in the API, organization provider configurations, usage aggregates and capability endpoints.
Agents
Agents are reported by workers: each worker's record (GET /orgs/:orgId/workers) lists the agents it detected,
whether they are enabled and authenticated. agentctl agent list summarises them across workers.
Providers
Add-on providers are configured on workers, and each worker reports its providers (masked). Organization-level provider configurations are exposed at:
| Method and path | Purpose | Permission |
|---|---|---|
GET /orgs/:orgId/providers | Organization provider configurations | member |
DELETE /orgs/:orgId/providers/:providerId | Delete one | provider.manage |
Usage
GET /orgs/:orgId/usage returns AI usage aggregates — tokens and cost per task, agent, provider and model, as the
agents reported them.
Capabilities
| Method and path | Purpose | Permission |
|---|---|---|
GET /orgs/:orgId/capabilities | Registry (organization and platform) | member |
POST /orgs/:orgId/capabilities | Register a manifest | capability.manage |
GET /orgs/:orgId/capability-installations | Installations (?projectId=) | member |
POST /orgs/:orgId/capability-installations | Install at a scope | capability.install |
POST …/capability-installations/:id/approve | Approve a pending installation | capability.manage |
PATCH …/capability-installations/:id | Enable or disable | member |
DELETE …/capability-installations/:id | Uninstall | member |