circle-info
Squadcast is now SolarWinds Incident Response

Teams

Get All Teams

get
/v3/teams

Returns all the teams of the organization. Requires access_token as a Bearer {{token}} in the Authorization header with read scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
chevron-right
200

The request has succeeded.

application/json
get
/v3/teams

Create Team

post
/v3/teams

Add team to the organization. Returns the team object in response. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
namestringRequired
descriptionstringOptional
member_idsstring[]Required
Responses
post
/v3/teams

Get Team By ID

get
/v3/teams/{teamId}

Returns a team details of the given teamID in the request param. Requires access_token as a Bearer {{token}} in the Authorization header with read scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/v3/teams/{teamId}

Update Team

put
/v3/teams/{teamId}

Update organization team details. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Body
namestringOptional
descriptionstringOptional
Responses
chevron-right
200

The request has succeeded.

application/json
put
/v3/teams/{teamId}

Remove Team

delete
/v3/teams/{teamId}

Remove team from the organization. Upon success, the team will be removed from the organization. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Responses
delete
/v3/teams/{teamId}

Get All Team Members

get
/v3/teams/{teamId}/members

Returns all the team members of the organization. Requires access_token as a Bearer {{token}} in the Authorization header with read scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/v3/teams/{teamId}/members

Add Team Member

post
/v3/teams/{teamId}/members

Add team member to the team. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Body
user_idstringRequired
role_idsstring[]Required

this field is required if you are using RBAC permission model

rolestringOptional

this field is required if you are using OBAC permission model

Responses
post
/v3/teams/{teamId}/members

Add Bulk Team Member

post
/v3/teams/{teamId}/members/bulk

Add team member to the team. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Body
Responses
chevron-right
200

The request has succeeded.

application/json
post
/v3/teams/{teamId}/members/bulk

Remove Team Member

delete
/v3/teams/{teamId}/members/{memberId}

Remove team member from the team. Upon success, the team member will be removed from the team. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
memberIdstringRequired
Responses
delete
/v3/teams/{teamId}/members/{memberId}

Update Team Member

patch
/v3/teams/{teamId}/members/{memberId}

Update team member. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
memberIdstringRequired
Body
role_idsstring[]Optional

this field is required if you are using RBAC permission model

rolestringOptional

this field is required if you are using OBAC permission model

Responses
chevron-right
200

The request has succeeded.

application/json
patch
/v3/teams/{teamId}/members/{memberId}

Get All Team Roles

get
/v3/teams/{teamId}/roles

Returns all the roles of the teamId mentioned in params. Requires access_token as a Bearer {{token}} in the Authorization header with read scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/v3/teams/{teamId}/roles

Create Team Role

post
/v3/teams/{teamId}/roles

Add team's role to the team with given ability if not exists. Returns the role object in response. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
Body
namestringRequired
Responses
post
/v3/teams/{teamId}/roles

Update Team Role

put
/v3/teams/{teamId}/roles/{roleId}

Update team's role abilities and name. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
roleIdstringRequired
Body
namestringOptional
Responses
chevron-right
200

The request has succeeded.

application/json
put
/v3/teams/{teamId}/roles/{roleId}

Remove Team Role

delete
/v3/teams/{teamId}/roles/{roleId}

Remove team's role from the team. Upon success, the team's role will be removed from the team. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
teamIdstringRequired
roleIdstringRequired
Responses
delete
/v3/teams/{teamId}/roles/{roleId}

Last updated