PUT /teams/{id}/users/{user_id}

Add a user to a team. Attempting to add a user with the read_only_user role will return a 400 error.

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

Servers

Path parameters

Name Type Required Description
id String Yes

The ID of the resource.

user_id String Yes

The user ID on the team.

Request headers

Name Type Required Description
Accept String Yes

The Accept header is used as a versioning header.

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

Content-Type String Yes

Possible values:

  • "application/json"

Default value: "application/json"

Request body fields

Name Type Required Description
role String No

The role of the user on the team.

Possible values:

  • "manager"
  • "observer"
  • "responder"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.