Organizations

Organizations are the top-level grouping in Technical Debt Radar. Every repository, team member, and billing subscription belongs to an organization. Users can belong to multiple organizations, and each organization has its own plan, billing, and settings.

Organization Properties

Property	Description
Name	Display name (e.g., "Acme Engineering")
Slug	URL-safe identifier (e.g., acme-engineering), unique across all orgs
Avatar	Organization logo, displayed in the dashboard and PR comments
Plan	Current subscription plan (Free, Solo, Pro, Team, Enterprise)
Billing	Payment method, billing cycle, and invoice history

Organization Limits by Plan

Plan	Max Organizations
Free	1
Solo	1
Pro	3
Team	10
Enterprise	Unlimited

These limits apply per user account. A single user can own or be a member of up to the number of organizations allowed by their highest-tier plan.

Creating an Organization

1. Click your avatar in the top-right corner of the dashboard
2. Select Create Organization
3. Enter the organization name
4. The slug is auto-generated from the name (editable)
5. Optionally upload an avatar
6. Click Create

The creator automatically becomes the owner of the new organization.

# CLI
radar org create --name "Acme Engineering"

Organization Settings

Go to Settings (gear icon) within an organization to manage:

General

• Name --- Update the display name
• Slug --- Change the URL slug (updates all dashboard URLs; old slug redirects for 30 days)
• Avatar --- Upload or change the organization logo
• Default branch --- The branch used as baseline for debt score comparisons (default: main)

Repositories

• View all connected repositories
• Add or remove repository connections
• Set per-repo overrides for radar.yml location

Notifications

• Configure Slack webhook URL for scan notifications
• Set notification preferences (all scans, failures only, weekly digest)

Danger Zone

• Transfer ownership
• Delete organization

Multiple Organizations

Users on Pro+ plans can belong to multiple organizations. Common scenarios:

• Consultants managing multiple client codebases, each in a separate org
• Open source maintainers with a personal org and a project org
• Companies with separate orgs for different products or teams

Switch between organizations using the org selector in the top-left corner of the dashboard.

Each organization has independent:

• Billing and subscription
• AI credit allocation
• Repositories and scan history
• Members and roles
• Configuration and policies

Transferring Ownership

Only the current owner can transfer ownership to another member:

1. Go to Settings then Danger Zone
2. Click Transfer Ownership
3. Select the new owner from the member list (they must already be a member of the org)
4. Confirm the transfer
5. The previous owner becomes an admin

Important: Ownership transfer also transfers billing responsibility. The new owner's payment method will be charged for the next billing cycle. Ensure the new owner has a valid payment method on file before transferring.

Leaving an Organization

Members and admins can leave an organization at any time:

1. Go to the organization's Members page
2. Click Leave Organization at the bottom of the page
3. Confirm

Owners cannot leave an organization. To leave, first transfer ownership to another member.

Deleting an Organization

Only the owner can delete an organization:

1. Go to Settings then Danger Zone
2. Click Delete Organization
3. Type the organization slug to confirm
4. Click Delete Permanently

Deleting an organization:

• Cancels the subscription immediately (no refund for the current cycle)
• Removes all repository connections
• Deletes all scan history and debt score data
• Removes all member associations
• Cannot be undone

Warning: Organization deletion is permanent and irreversible. Export any data you need before deleting. Scan history can be exported as JSON from Settings then Data Export.