---
title: "Create a Synthetics downtime"
method: POST
path: "/api/v2/synthetics/downtimes"
tags: ["Synthetics"]
---

# Create a Synthetics downtime

`POST /api/v2/synthetics/downtimes`

Create a new Synthetics downtime.

## Request body

- SyntheticsDowntimeRequest — Request body for creating or updating a Synthetics downtime.
  - `data` SyntheticsDowntimeDataRequest, required — The data object for a Synthetics downtime create or update request.
    - `attributes` SyntheticsDowntimeDataAttributesRequest, required — Attributes for creating or updating a Synthetics downtime.
      - `description` string — An optional description of the downtime.
      - `isEnabled` boolean, required — Whether the downtime is enabled.
      - `name` string, required — The name of the downtime.
      - `tags` string[] — List of tags associated with a Synthetics downtime.
      - `testIds` string[], required — List of Synthetics test public IDs associated with a downtime.
      - `timeSlots` SyntheticsDowntimeTimeSlotRequest[], required — List of time slots for a Synthetics downtime create or update request.
        - `duration` integer, required — The duration of the time slot in seconds, between 60 and 604800.
        - `name` string — An optional label for the time slot.
        - `recurrence` SyntheticsDowntimeTimeSlotRecurrenceRequest — Recurrence settings for a Synthetics downtime time slot.
          - `end` SyntheticsDowntimeTimeSlotDate — A specific date and time used to define the start or end of a Synthetics downtime time slot.
            - `day` integer, required — The day component of the date (1-31).
            - `hour` integer, required — The hour component of the time (0-23).
            - `minute` integer, required — The minute component of the time (0-59).
            - `month` integer, required — The month component of the date (1-12).
            - `year` integer, required — The year component of the date.
          - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', required — The recurrence frequency of a Synthetics downtime time slot.
          - `interval` integer — The interval between recurrences, relative to the frequency.
          - `weekdayPositions` SyntheticsDowntimeWeekdayPosition[] — Positions of the weekdays within a month for a monthly Synthetics downtime recurrence. Used in combination with `weekdays` to schedule occurrences such as "the first Monday of the month".
          - `weekdays` SyntheticsDowntimeWeekday[] — Days of the week for a Synthetics downtime recurrence schedule.
        - `start` SyntheticsDowntimeTimeSlotDate, required — A specific date and time used to define the start or end of a Synthetics downtime time slot.
          - `day` integer, required — The day component of the date (1-31).
          - `hour` integer, required — The hour component of the time (0-23).
          - `minute` integer, required — The minute component of the time (0-59).
          - `month` integer, required — The month component of the date (1-12).
          - `year` integer, required — The year component of the date.
        - `timezone` string, required — The IANA timezone name for the time slot.
    - `type` 'downtime', required — The resource type for a Synthetics downtime.

## Response `201`

Created

- SyntheticsDowntimeResponse — Response containing a single Synthetics downtime.
  - `data` SyntheticsDowntimeData, required — A Synthetics downtime object.
    - `attributes` SyntheticsDowntimeDataAttributesResponse, required — Attributes of a Synthetics downtime response object.
      - `createdAt` string, date-time, required — The timestamp when the downtime was created.
      - `createdBy` string, required — The UUID of the user who created the downtime.
      - `createdByName` string, required — The display name of the user who created the downtime.
      - `description` string, required — The description of the downtime.
      - `isEnabled` boolean, required — Whether the downtime is enabled.
      - `name` string, required — The name of the downtime.
      - `tags` string[], required — List of tags associated with a Synthetics downtime.
      - `testIds` string[], required — List of Synthetics test public IDs associated with a downtime.
      - `timeSlots` SyntheticsDowntimeTimeSlotResponse[], required — List of time slots in a Synthetics downtime response.
        - `duration` integer, required — The duration of the time slot in seconds.
        - `id` string, required — The unique identifier of the time slot.
        - `name` string — The label for the time slot.
        - `recurrence` SyntheticsDowntimeTimeSlotRecurrenceResponse — Recurrence settings returned in a Synthetics downtime time slot response.
          - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', required — The recurrence frequency of a Synthetics downtime time slot.
          - `interval` integer, required — The interval between recurrences, relative to the frequency.
          - `until` SyntheticsDowntimeTimeSlotDate — A specific date and time used to define the start or end of a Synthetics downtime time slot.
            - `day` integer, required — The day component of the date (1-31).
            - `hour` integer, required — The hour component of the time (0-23).
            - `minute` integer, required — The minute component of the time (0-59).
            - `month` integer, required — The month component of the date (1-12).
            - `year` integer, required — The year component of the date.
          - `weekdayPositions` SyntheticsDowntimeWeekdayPosition[] — Positions of the weekdays within a month for a monthly Synthetics downtime recurrence. Used in combination with `weekdays` to schedule occurrences such as "the first Monday of the month".
          - `weekdays` SyntheticsDowntimeWeekday[], required — Days of the week for a Synthetics downtime recurrence schedule.
        - `start` SyntheticsDowntimeTimeSlotDate, required — A specific date and time used to define the start or end of a Synthetics downtime time slot.
          - `day` integer, required — The day component of the date (1-31).
          - `hour` integer, required — The hour component of the time (0-23).
          - `minute` integer, required — The minute component of the time (0-59).
          - `month` integer, required — The month component of the date (1-12).
          - `year` integer, required — The year component of the date.
        - `timezone` string, required — The IANA timezone name for the time slot.
      - `updatedAt` string, date-time, required — The timestamp when the downtime was last updated.
      - `updatedBy` string, required — The UUID of the user who last updated the downtime.
      - `updatedByName` string, required — The display name of the user who last updated the downtime.
    - `id` string, required — The unique identifier of the downtime.
    - `type` 'downtime', required — The resource type for a Synthetics downtime.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)