Teams
Teams provide a powerful way to collaborate on AI projects by creating shared workspaces where multiple users can access and manage resources collectively. When you create a team and add members, those team members gain visibility and access to resources associated with the team, streamlining collaboration without requiring individual resource sharing.
This collaboration model is particularly valuable for organizations where multiple people work on the same bots, datasets, or integrations. Instead of duplicating resources or managing complex individual permissions, teams provide a clean, organizational structure that naturally supports collaborative workflows.
Listing Your Teams
You can retrieve a list of all teams you've created to view your collaborative workspaces and understand how resources are organized across different groups. The list includes team metadata, member information, and creation timestamps to help you manage your team structure effectively.
The response includes all teams where you are the owner, providing a complete view of the collaborative workspaces you manage. Each team entry includes its name, description, and any custom metadata you've attached for organizational purposes.
Team Organization Strategies
Teams are commonly organized by:
- Project: Separate teams for different customer projects or initiatives
- Department: Marketing, engineering, support, or other functional teams
- Client: Dedicated teams for managing resources for specific clients
- Environment: Development, staging, and production teams
- Product Line: Different teams for distinct product offerings
By maintaining well-organized teams, you create clear boundaries for resource access and simplify permission management as your organization grows.
Pagination Support
For accounts managing many teams, the list endpoint supports cursor-based pagination to efficiently handle large team collections:
You can also filter teams by metadata to quickly locate specific teams based on tags or categorization you've applied. This is particularly useful for large organizations with complex team structures.
Note: Team functionality enables resource sharing and collaborative workflows, but remember that resource-level permissions and access controls still apply. Team membership provides visibility but doesn't automatically grant modification permissions unless the resource's access settings permit it.