Search Teams

Search for teams in your PagerDuty instance.

Options

Field Definition Type Required
Result Set Choose one of the following options to display your search results:

  • First Matching Record: returns a single team

  • First 100 Matching Records: returns the first 100 matching team records

  • Stream Matching Records: pass all matching team records from your parent flow to a helper flow; a Streaming input section will be added to the card from which you can select a helper flow for streaming and adding custom extensible fields.

Dropdown

TRUE

To learn how to use the Stream Matching Records option and set up a helper flow to return a large number of records, see Stream matching records with a helper flow.

Input

Field Definition Type Required

Search By

Name Full or partial strings used to query records based on a value in the team's Name field. For example, to search for the team 70hgUr6Tga, any of the following are valid query terms:

  • 70hgUr6Tga

  • hgUr

Text

TRUE

Search Criteria

Records Limit Specified maximum number of records that can be streamed. The minimum allowable value is 1; the maximum is 1,000,000.

Records Limit input field is only available with the Stream Matching Records option.

Number

FALSE

Streaming

Flow

 Click Choose Flow to browse and select a helper flow to which the search results will be streamed, then click Choose to confirm.

Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow.

Flow

TRUE

Output

Field Definition Type
Teams List of teams that match the search criteria.

Object
Team ID Unique identifier of the team profile.

Text
Name Team's name.

Text
Summary A short string that provides succinct, information about the team. In many cases, this will be identical to Name, though it is not intended to be an identifier.

Text
Description A short description assigned to the team.

Text
Type Types of roles that are assigned to members of the team. A type can be team or team_reference.

Text
Default Role Default role for a member of the team.

Text
HTML URL URL for the team profile in your PagerDuty instance.

Text
Parent Unique identifier of the parent team profile.

List of Objects
ID Unique identifier of the parent team profile.

Text
Summary A short string that provides succinct, information about the parent team. In many cases, this will be identical to Name, though it is not intended to be an identifier.

Text
Type Types of roles that are assigned to members of the parent team. A type can be team or team_reference.

Text
HTML URL URL for the parent team profile in your PagerDuty instance.

Text

Related topics

PagerDuty connector

Workflow elements

PagerDuty REST API