Skip to main content

updateTeam

A Graze API POST request that updates an existing team.

Back to Graze API EndPoint Reference.

Request arguments

Endpoint updateTeam takes the following request arguments:

Name

Type

Required

Description

auth_token

String

Yes

A valid auth_token returned from the authenticate request. Alternatively, basic authenticate headers can be used in place of this parameter. See the authenticate endpoint for more information and usage examples.

team_id

Number

Yes

Team ID.

name

String

No

Team name. Exclude this attribute to leave Moogsoft Onprem as it is.

alert_filter

String

No

An SQL-like filter that alerts must match to be assigned to the team. Exclude this attribute to leave Moogsoft Onprem as it is.

See Filter Search Data for more information on creating SQL-like filters.

services

Array of Strings or Numbers

No

List of the team service names or IDs. Exclude this attribute to leave Moogsoft Onprem as it is.

sig_filter

String

No

An SQL-like filter that Situations must match to be assigned to the team. Exclude this attribute to leave Moogsoft Onprem as it is.

See Filter Search Data for more information on creating SQL-like filters.

landing_page

String

No

Default landing page for the team. Exclude this attribute to leave Moogsoft Onprem as it is.

active

Boolean

No

Set to true if the team is active; set to false if the team is inactive. Default is true. Exclude this attribute to leave Moogsoft Onprem as is.

description

String

No

Team description. Exclude this attribute to leave Moogsoft Onprem as it is.

users

Array of Strings or Numbers

No

List of users in the team, either IDs or usernames. Exclude this attribute to leave Moogsoft Onprem as it is.

Response

Endpoint updateTeam returns the following response:

Examples

The following examples demonstrate typical use of endpoint updateTeam:

Request example

Example cURL request to update the information for team ID 16:

curl -X POST -u graze:graze -k -v "https://localhost/graze/v1/updateTeam" \
-H "Content-Type: application/json; charset=UTF-8" \
-d '{"team_id" : 16, "name" : "my team name RENAMED", "active" : true, "description" : "The team description", "users" : []}'

Response example