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
Tip

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

 String 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. String
Name Team's name. String
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. String
Description A short description assigned to the team. String
Type Types of roles that are assigned to members of the team. A type can be team or team_reference. String
Default Role Default role for a member of the team. String
HTML URL URL for the team profile in your PagerDuty instance. String
Parent Unique identifier of the parent team profile. List of Objects
ID Unique identifier of the parent team profile. String
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. String
Type Types of roles that are assigned to members of the parent team. A type can be team or team_reference. String
HTML URL URL for the parent team profile in your PagerDuty instance. String

Related topics

PagerDuty connector

Workflow elements

PagerDuty REST API