updateTeam

A Graze API POST request that updates an existing team.

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 Enterprise 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 Enterprise 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 Enterprise 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 Enterprise 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 Enterprise 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 Enterprise as is.
`description`	String	No	Team description. Exclude this attribute to leave Moogsoft Enterprise 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 Enterprise as it is.

Response

Endpoint updateTeam returns the following response:

Type	Description
HTTP Code	HTTP status or error code indicating request success or failure. See HTTP status code definitions for more information.

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

In this section: