---
title: "Partial Update Blackout Period"
method: PATCH
path: "/targets/{target_id}/blackout-periods/{id}/"
tags: ["Blackout Periods"]
---

# Partial Update Blackout Period

`PATCH /targets/{target_id}/blackout-periods/{id}/`

## Request

- Base URL: `https://api.probely.com`
- URL: `https://api.probely.com/targets/{target_id}/blackout-periods/{id}/`
- Auth: API key in header `Authorization`

## Path parameters

- `id` string, required: A unique Base58 value identifying this object.
- `target_id` string, required

## Request body

- PatchedBlackoutPeriod
  - `id` string: A unique Base58 value identifying this object.
  - `begin` string, time: Time of when the blackout period starts, in ISO 8601 UTC format. For example, "13:27".
  - `cease` string, time: Time of when the blackout period ceases, in ISO 8601 UTC format. For example, "13:27".
  - `weekdays` integer[]
  - `enabled` boolean: If true, the blackout period is enabled.
  - `timezone` string
  - `changed` string, date-time: Date and time of the last change, in ISO 8601 UTC format. For example, "2023-08-09T13:27:43.8208302".
  - `changed_by` SimpleUser
    - `id` string, required: A unique Base58 value identifying this object.
    - `email` string, email: Email of the user.
    - `name` string, required: Name of the user.

## Response `200`

- BlackoutPeriod
  - `id` string, required: A unique Base58 value identifying this object.
  - `begin` string, time, required: Time of when the blackout period starts, in ISO 8601 UTC format. For example, "13:27".
  - `cease` string, time, required: Time of when the blackout period ceases, in ISO 8601 UTC format. For example, "13:27".
  - `weekdays` integer[], required
  - `enabled` boolean: If true, the blackout period is enabled.
  - `timezone` string
  - `changed` string, date-time, required: Date and time of the last change, in ISO 8601 UTC format. For example, "2023-08-09T13:27:43.8208302".
  - `changed_by` SimpleUser, required
    - `id` string, required: A unique Base58 value identifying this object.
    - `email` string, email: Email of the user.
    - `name` string, required: Name of the user.

## Other responses

- `400`
- `401`
- `404`
- `500`

## Changes

- **2026-11-03** `0b2f6cbe644d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation/changes/targets/:target_id/blackout-periods/:id/patch.md)

---

[API](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation.md) - [All operations](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation/revisions/0b2f6cbe644d?raw)