---
title: "Update"
method: PUT
path: "/alerts_policies/{policy_id}.json"
tags: ["Alerts Policies"]
---

# Update

`PUT /alerts_policies/{policy_id}.json`

## Request

- Base URL: `https://api.newrelic.com/v2`
- URL: `https://api.newrelic.com/v2/alerts_policies/{policy_id}.json`
- Auth: API key in header `Api-Key`
- TypeScript: <https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/docs/alerts_policies/:policy_id.json/put.ts> (a function with typed inputs; its response is checked against the schema)

🔥🔥 New users should use <a href="https://docs.newrelic.com/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/alerts-nerdgraph/nerdgraph-api-examples/">these docs about managing alerts via NerdGraph.</a>

<p>This API endpoint updates Alerts policies associated with your New Relic account.</p>

<p>Note: <a href="https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/rest-api-key">Admin User’s API Key</a> is required.</p>

<p>See our documentation for a discussion on using the REST API for
<a href="https://docs.newrelic.com/docs/alerts/new-relic-alerts/rest-api-alerts/rest-api-calls-new-relic-alerts#policies-update" target="_blank">updating policies</a>.</p>

## Path parameters

- `policy_id` integer, required

## Request body

- Policy
  - `policy` PolicyBody
    - `incident_preference` string
    - `name` string

## Response `200`

No response was specified

- PolicyResponse
  - `policy` PolicyResponseType
    - `created_at` integer
    - `id` integer
    - `incident_preference` string
    - `name` string
    - `updated_at` integer

---

[API](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2.md) - [All operations](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/revisions/cf1843ad0a45?raw)