Settings & Management
Get Teams
Retrieve data for all teams registered on the platform
GET
Overview
The Teams endpoint provides access to team definitions and membership within the ThreatAware platform. Teams enable collaborative access to subsets of devices, users, and dashboards.Parameters
number
default:"0"
Set the start position of the data returned by the API
number
default:"0"
Limit each request by the provided number. Leave blank or as 0 to return all data available
Authentication
string
required
Your ThreatAware API key
string
default:"application/json"
Response format
Response
number
The starting position of this result set
number
The number of results returned
number
Total number of teams
boolean
Whether the request was successful
number
HTTP status code
string
Status message
array
Team-Based Access Control
Teams enable delegation of access within ThreatAware:Device Visibility
Device Visibility
Tag-Based ScopingTeams can be scoped to see only devices with specific tags. For example:
- “IT Service Desk” team sees only devices tagged
IT-Managed - “MSP Client A” team sees only devices tagged
Client-A
Saved Views & Dashboards
Saved Views & Dashboards
Team-Shared ResourcesTeams can share:
- Device saved views (filtered device lists)
- User saved views
- AI Reporting dashboards
- Reports
Alert Assignment
Alert Assignment
Collaborative WorkflowsAlerts can be assigned to teams rather than individuals, allowing:
- Team members to pick up alerts from a shared queue
- Load balancing across team
- Coverage during absences
Use Cases
MSP Client Segmentation
Create a team per MSP client for isolated access
Department-Based Access
IT, Security, Compliance teams with scoped visibility
Collaboration Analytics
Track team membership and access patterns
Onboarding Automation
Automate team assignment during user onboarding
Related Endpoints
Get Users
View user accounts and their team memberships
Get Roles
View role definitions and permissions