Organization Management

Operate multi-user TheRouter.ai accounts safely

Organizations let teams share credits and policies while retaining per-key accountability for usage and incident response.

Roles and permissions

Admins can manage members, billing, and all keys. Members can create and use keys according to assigned policy scopes.

roles.txt

Admin
- manage members
- manage all keys
- configure billing and policies

Member
- create personal keys
- use shared organization resources

Key management workflow

Use one key per service and environment. Prefer short key names that encode service ownership and rotation epoch.

TypeScript

const keyName = "svc-billing-api-prod-2026q1";
await fetch("https://api.therouter.ai/v1/keys", {
  method: "POST",
  headers: { Authorization: "Bearer <MGMT_KEY>", "Content-Type": "application/json" },
  body: JSON.stringify({ name: keyName, limit: 1500 }),
});

Shared usage visibility

Use activity exports to build chargeback or cost-center reports. Group by API key and user IDs for transparent internal accounting.

Metadata visibility

Organization members may see organization-level usage metadata. Do not rely on org boundaries to hide business-level traffic patterns.