Update a team

Update an existing team.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

For more information see the API Concepts Document

Scoped OAuth requires: teams.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Request Body

application/json

The team to be updated.

TypeScript Definitions

Use the request body type in TypeScript.

team*

Response Body

`application/json`

curl -X PUT "https://example.com/teams/{id}" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "team": {      "type": "team",      "name": "Engineering",      "description": "The engineering team"    }  }'

{  "team": {    "id": "PQ9K7I8",    "type": "team",    "summary": "Engineering",    "self": "https://api.pagerduty.com/teams/PQ9K7I8",    "html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8",    "name": "Engineering",    "description": "All engineering",    "default_role": "manager"  }}

Update a team

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

401application/json

402application/json

403application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`