← Back to Blog

Teams: Organize your org with teams and roles

Quantlix Team

As your organization grows, you need a way to group people and projects. Teams give you that structure — and fine-grained control over who can do what.

The hierarchy

Quantlix organizes resources in a simple hierarchy: **Org → Team → Project → Deployment**. Teams sit between your organization and your projects. Use them to group deployments by team (e.g. "Platform Engineering", "Data Science"), add members with specific roles, and control who can manage resources.

Roles that make sense

Each team member has a role:

- **Team Admin** — Add and remove members, change roles, edit the team. Full control.

- **Developer** — Create and edit deployments, providers, knowledge bases. Use API keys. The default for builders.

- **Viewer** — Read-only. Can see team resources but not change them.

Org admins and owners can manage any team in their org — add members, edit, delete — even if they're not team members. That keeps governance at the org level while teams handle day-to-day work.

How to use it

In the portal, go to **Dashboard → Teams**. Select your org, create a new team, then add members from your org. Assign each person a role. When you create a project or deployment, you can assign it to a team so the right people have access.

You can also manage teams via API:

# Create a team
curl -s -X POST "$API_URL/orgs/$ORG_ID/teams" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Platform Engineering", "description": "Core platform team"}' | python3 -m json.tool

# Add a member
curl -s -X POST "$API_URL/teams/$TEAM_ID/members" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "user-uuid", "role": "developer"}' | python3 -m json.tool

Why it matters

Without teams, everyone in an org is either an admin or a regular member — and "regular" often means too much or too little access. Teams let you scope permissions to the right people and projects. You get a clean structure for growing organizations without overcomplicating things.