Team API Overview
Looking for the product view?
The Help Center explains this surface as users see it: Teams and Users.
The Informer Team API provides comprehensive endpoints for managing teams, their members, and team-specific resources including AI usage profile assignment. All routes are prefixed with /api.
Features
- CRUD Operations - Create, read, update, and delete teams
- Member Management - Add, remove, and manage team members with roles
- Memberships - Bulk membership operations
- Activity Feed - Team activity notifications
- Comments - Team discussions
- AI Profile - Assign a usage profile that governs model-tier access and credit limits for the team's members
Team Structure
A team consists of:
| Component | Description |
|---|---|
| id | Unique team identifier (prefixed with team:) |
| name | Team display name |
| description | Team description |
| icon | Custom icon/logo |
| materialIcon | Material icon name |
| color | Team color (hex) |
| settings | Team preferences (JSONB) |
| createdAt | Creation timestamp |
Team Roles
Members can have different roles:
| Role | Permissions |
|---|---|
| admin | Full team management and content control |
| publisher | Publish and share content |
| dataWizard | Create and manage data resources |
| designer | Design reports and visuals |
| memberPlus | Extended viewing capabilities |
| member | Basic viewing and collaboration |
Authentication
All Team API endpoints require authentication via session cookies or API tokens.
Common Permission Patterns
- Create teams -
teams:createpermission - Edit team - Team admin or superuser
- Manage members - Team admin
- View team - Team membership or shared content access
Next Steps
Explore the specific endpoint categories:
- Core CRUD - Basic team operations
- Members - Member management
- Feed & Comments - Team activity