---
title: "Update Repair Order Notification Policy"
method: PATCH
path: "/repair_order_notification_policies/{id}"
tags: ["Repair Order Notification Policies"]
---

# Update Repair Order Notification Policy

`PATCH /repair_order_notification_policies/{id}`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/repair_order_notification_policies/{id}`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/repair_order_notification_policies/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates an existing Repair Order Notification Policy on your account.
This endpoint updates the top-level policy configuration, even if the Fleetio
UI refers to that configuration more broadly as a "subscription".
Groups are updated by replacing the full `group_ids` set. Send the complete desired set of Group ids, or an empty array to remove all Groups.
Subscription recipients are specified by `contact_id`.
Contacts can only be added as recipients if they belong to the current account and have an associated User.
Existing subscription settings can be updated by `id` alone without sending
`contact_id` when the recipient is not changing.

## Path parameters

- `id` string, required

## Request body

- object
  - `all_vehicles` boolean
  - `name` string, nullable
  - `notification_frequency_in_minutes` 10 | 20 | 30 | 60 | 240 | 720 | 1440, nullable
  - `group_ids` Id[]: Replaces the full set of Groups on the policy. Provide the complete set of desired Group ids. Use an empty array to remove all Groups.
  - `subscriptions` object[]: Subscription updates for this policy. Existing subscription settings can be updated by `id` alone when the recipient is not changing.
    - `id` integer
    - `_destroy` boolean: Set to `true` to remove an existing subscription. When removing a subscription, provide exactly one of `id` or `contact_id` to identify the existing subscription.
    - `contact_id` integer
    - `email` boolean
    - `text_message` boolean
    - `text_message_phone_type` string, nullable

## Response `200`

OK

- RepairOrderNotificationPolicySummary, nullable: A lightweight list representation of a Repair Order Notification Policy. In the Fleetio UI, the top-level configuration may be labeled as a "subscription". In this API, the top-level resource is a Repair Order Notification Policy. Use the show endpoint for full group and recipient details.
  - `id` integer
  - `name` string, nullable
  - `all_vehicles` boolean
  - `notification_frequency_in_minutes` integer, nullable: Notification frequency in minutes. A null value indicates the policy is using the default notification schedule.
  - `groups_count` integer
  - `users_count` integer

## Other responses

- `401`: Request could not be authenticated
- `403`: Insufficient permission to perform this operation
- `404`: The requested resource could not be located
- `422`: Unprocessable Entity
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 4 breaking
  - added `#/components/schemas/Id` to the `subscriptions/items/contact_id` request property `allOf` list
  - added `#/components/schemas/Id` to the `subscriptions/items/id` request property `allOf` list
  - the `subscriptions/items/contact_id` request property type changed from `integer` to no type
  - the `subscriptions/items/id` request property type changed from `integer` to no type
- **2026-06-16** `4098a1c81821`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/repair_order_notification_policies/:id/patch.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)