Xagent Docs
Get started

Members & Roles

A team is a shared workspace. Members collaborate on the same agents, knowledge bases, and tasks, and roles determine what each member can do.

Roles

RoleCapabilities
OwnerFull control: manage billing, members, tools, and delete the team.
AdminManage members and tool configuration; invite and remove users.
MemberCreate and run agents within the workspace.

Managing Members

List members, or remove one (team admins, or a member removing themselves to leave). The API's team_role is admin or member.

List members — GET /api/teams/{team_id}/members:

[
  { "id": 1, "user_id": 7, "username": "ada", "team_role": "admin", "joined_at": "2026-07-01T08:00:00Z" },
  { "id": 2, "user_id": 9, "username": "grace", "team_role": "member", "joined_at": "2026-07-03T10:30:00Z" }
]

Remove a member — DELETE /api/teams/{team_id}/members/{user_id}:

{ "message": "Member removed successfully" }

Errors: 404 "Member not found"; 403 "Promote another admin before leaving" (the last admin of a multi-member team must promote someone first); 403 "Not your team".

Team Tool Configuration

Owners and admins decide which tools are available to everyone in the team:

GET /api/teams/{team_id}/tools
GET /api/teams/{team_id}/tools/available
PUT /api/teams/{team_id}/tools/{tool_name}/enabled

One workspace, shared quota

All members draw from the same plan limits. Monitor consumption on the usage page.

Next Steps