Update a service

Update an existing service.

A service may represent an application, component, or team you wish to open incidents against.

There is a limit of 100,000 open Incidents per Service. If the limit is reached and you disable auto_resolve_timeout (set to 0 or null), the API will respond with an error.

For more information see the API Concepts Document

Scoped OAuth requires: services.write

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.

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"

Request Body

application/json

The service to be updated.

TypeScript Definitions

Use the request body type in TypeScript.

service*

Response Body

`application/json`

curl -X PUT "https://example.com/services/{id}" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "service": {      "type": "service",      "name": "My Web App",      "description": "My cool web application that does things.",      "auto_resolve_timeout": 14400,      "acknowledgement_timeout": 600,      "status": "active",      "escalation_policy": {        "id": "PWIP6CQ",        "type": "escalation_policy_reference"      },      "incident_urgency_rule": {        "type": "use_support_hours",        "during_support_hours": {          "type": "constant",          "urgency": "high"        },        "outside_support_hours": {          "type": "constant",          "urgency": "low"        }      },      "support_hours": {        "type": "fixed_time_per_day",        "time_zone": "America/Lima",        "start_time": "09:00:00",        "end_time": "17:00:00",        "days_of_week": [          1,          2,          3,          4,          5        ]      },      "scheduled_actions": [        {          "type": "urgency_change",          "at": {            "type": "named_time",            "name": "support_hours_start"          },          "to_urgency": "high"        }      ],      "alert_creation": "create_alerts_and_incidents",      "alert_grouping_parameters": {        "type": "time",        "config": {          "timeout": 2        }      },      "auto_pause_notifications_parameters": {        "enabled": true,        "timeout": 300      }    }  }'

{  "service": {    "id": "PIJ90N7",    "type": "service",    "summary": "My Application Service",    "self": "https://api.pagerduty.com/services/PIJ90N7",    "html_url": "https://subdomain.pagerduty.com/service-directory/PIJ90N7",    "name": "My Application Service",    "auto_resolve_timeout": 14400,    "acknowledgement_timeout": 600,    "created_at": "2015-11-06T11:12:51-05:00",    "status": "active",    "alert_creation": "create_alerts_and_incidents",    "alert_grouping_parameters": {      "type": "time",      "config": {        "timeout": 2      }    },    "integrations": [      {        "id": "PQ12345",        "type": "generic_email_inbound_integration_reference",        "summary": "Email Integration",        "self": "https://api.pagerduty.com/services/PIJ90N7/integrations/PQ12345",        "html_url": "https://subdomain.pagerduty.com/services/PIJ90N7/integrations/PQ12345"      }    ],    "escalation_policy": {      "id": "PT20YPA",      "type": "escalation_policy_reference",      "summary": "Another Escalation Policy",      "self": "https://api.pagerduty.com/escalation_policies/PT20YPA",      "html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA"    },    "teams": [      {        "id": "PQ9K7I8",        "type": "team_reference",        "summary": "Engineering",        "self": "https://api.pagerduty.com/teams/PQ9K7I8",        "html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8"      }    ],    "incident_urgency_rule": {      "type": "use_support_hours",      "during_support_hours": {        "type": "constant",        "urgency": "high"      },      "outside_support_hours": {        "type": "constant",        "urgency": "low"      }    },    "support_hours": {      "type": "fixed_time_per_day",      "time_zone": "America/Lima",      "start_time": "09:00:00",      "end_time": "17:00:00",      "days_of_week": [        1,        2,        3,        4,        5      ]    },    "scheduled_actions": [      {        "type": "urgency_change",        "at": {          "type": "named_time",          "name": "support_hours_start"        },        "to_urgency": "high"      }    ],    "auto_pause_notifications_parameters": {      "enabled": true,      "timeout": 300    }  }}

Update a service

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

401application/json

402application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`