Skip to main content
Configure roles, permissions, and teams to control what users can do in your Adaptive deployment.
  • Permissions grant ability to perform actions (e.g., use_case:adapt allows fine-tuning)
  • Roles are named sets of permissions, assignable to users
  • Teams are groups with shared access to use cases and resources
Users can belong to multiple teams with different roles in each.

​
Common Operations

# Create a user
adaptive.users.create(
    email="[email protected]",
    name="John Doe",
    teams_with_role=[("customer-support-team", "admin")]
)

# Add user to team
adaptive.users.add_to_team(
    email="[email protected]",
    team="customer-support-team",
    role="admin"
)

# Remove user from team
adaptive.users.remove_from_team(
    email="[email protected]",
    team="customer-support-team"
)

# Share use case with team
adaptive.use_cases.share(
    use_case="use-case-to-share",
    team="customer-support-team",
    role="admin",
    is_owner=False
)

# Create a team
adaptive.teams.create(
    key="customer-support-team",
    name="Customer Support Team",
)

# Create a custom role
adaptive.roles.create(
    key="new-role",
    permissions=["use_case:read", "use_case:create"]
)

​
Admin Team

The reserved admin team controls global operations. Members with admin or platform_admin role can:
  • Create new roles and teams
  • Add/remove users from any team
Configure seed admins in values.yaml: 
auth:
  default_role: admin  # admin, platform_admin, power_user, read-only, inference, annotator
  default_team: default
  admins: []  # Email addresses for initial admins

​
Default Roles

RoleKeyDescription
AdminadminAll permissions. Can create teams/roles only if in admin team.
Platform Adminplatform-adminManages roles, teams, and users. Requires admin team membership.
Power Userpower_userFull use case management, training, evaluation, model deployment.
Read Onlyread-onlyView use case details only.
InferenceinferenceInteract with models attached to team use cases.
AnnotatorannotatorInteract with models and add feedback.

​
All Permissions

​
Admin

PermissionScope
admin:manage_rolesList roles (any team), create roles (admin team)
admin:manage_teamsList teams (any team), create teams (admin team)
admin:manage_usersList/update users in same team, global update (admin team)

​
Use Case

PermissionScope
use_case:readView use case details
use_case:createCreate use cases
use_case:updateUpdate use case details
use_case:manage_modelsAttach/detach models
use_case:adaptTrain models
use_case:evaluateEvaluate models
use_case:interactChat with models
use_case:add_feedbackAdd interaction feedback
use_case:read_interactionsView logged interactions
use_case:update_interactionsUpdate interaction metadata
use_case:shareShare with another team (requires both team memberships)

​
Resources

PermissionScope
dataset:createCreate datasets
metric:createCreate feedback keys
model:manage_modelsDeploy/terminate models globally (admin team)
team:manageUpdate users in same team