Teams & Workspaces

Xagent is tenant-aware. A team is a workspace that groups users, shares a subscription plan and billing account, and scopes which tools are available. Agents, knowledge bases, and tasks live inside a team.

How Teams Work

  • Every user belongs to a team. New sign-ups get a personal team by default.
  • A team shares one plan — Free, Starter, or Business — which sets quota limits.
  • Team owners and admins invite members and assign roles.
  • Available tools can be enabled or disabled per team.

Create a Team

From the web app, open Teams → New Team, or use the API:

POST /api/teams            # create a team
GET  /api/teams            # list your teams
GET  /api/teams/my-team    # the current workspace

Invite Members

Invite teammates by email; they receive an invitation they can accept to join the workspace. See Invitations for the full flow.

POST /api/teams/{team_id}/invitations
GET  /api/teams/{team_id}/members

Workspace Keys

Each team can issue workspace API keys for the SDK, letting you manage agents programmatically across the whole workspace:

POST   /api/teams/{team_id}/workspace-keys
GET    /api/teams/{team_id}/workspace-keys
DELETE /api/teams/{team_id}/workspace-keys/{key_id}

Next Steps