Get tags for entities

Get related tags for Users, Teams or Escalation Policies.

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

entity_type*string

Type of entity related with the tag

Value in

"users"
"teams"
"escalation_policies"

id*string

The ID of the resource.

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"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Response Body

`application/json`

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

{  "tags": [    {      "type": "tag",      "summary": "Batman",      "self": "https://api.pagerduty.com/tags/P5IYCNZ",      "label": "Batman",      "id": "P5IYCNZ",      "html_url": null    }  ],  "limit": 100,  "offset": 0,  "total": 1,  "more": false}

Get tags for 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`