For AI agents and assistants: visit https://docs.pagerduty.com/llms.txt for the index.

Get connected entities

Get related Users, Teams or Escalation Policies for the Tag.

A Tag is applied to Escalation Policies, Teams or Users and can be used to filter them.

For more information see the API Concepts Document

Scoped OAuth requires: tags.read

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.

entity_type*string

Type of entity related with the tag

Value in

"users"
"teams"
"escalation_policies"

Query Parameters

limit?integer

The number of results per page.

offset?integer

Offset to start pagination search results.

total?boolean

By default the total field in pagination responses is set to null to provide the fastest possible response times. Set total to true for this field to be populated.

See our Pagination Docs for more information.

Defaultfalse

Header Parameters

Accept*string

The Accept header is used as a versioning header.

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

Response Body

`application/json`

curl -X GET "https://api.pagerduty.com/tags/{id}/users" \  -H "Accept: application/vnd.pagerduty+json;version=2"

{  "users": [    {      "id": "PXPGF42",      "type": "user_reference"    },    {      "id": "PAM4FGS",      "type": "user_reference"    }  ],  "limit": 100,  "offset": 0,  "total": 2,  "more": false}

Get connected entities

Authorization

Path Parameters

Query Parameters

Header Parameters

Response Body

200application/json

401application/json

403application/json

429application/json

Developer Agreement

`application/json`

`application/json`

`application/json`

`application/json`