Skip to main content
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:
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
This scoping is enforced throughout the platform (device views, reports, dashboards, API).
Team-Shared ResourcesTeams can share:
  • Device saved views (filtered device lists)
  • User saved views
  • AI Reporting dashboards
  • Reports
This enables collaboration within teams without sharing to entire organization.
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

Get Users

View user accounts and their team memberships

Get Roles

View role definitions and permissions