---
title: "Create an SLO correction"
method: POST
path: "/api/v1/slo/correction"
tags: ["Service Level Objective Corrections"]
---

# Create an SLO correction

`POST /api/v1/slo/correction`

Create an SLO correction. Use `slo_id` to apply the correction to a single SLO, or `slo_query` to apply the
correction to SLOs that match a query. Exactly one of `slo_id` or `slo_query` is required.

## Request body

- SLOCorrectionCreateRequest — An object that defines a correction to be applied to one or more SLOs.
  - `data` SLOCorrectionCreateData — The data object associated with the SLO correction to be created.
    - `attributes` SLOCorrectionCreateRequestAttributes — The attribute object associated with the SLO correction to be created. Exactly one of `slo_id` or `slo_query` must be provided.
      - `category` 'Scheduled Maintenance' | 'Outside Business Hours' | 'Deployment' | 'Other', required — Category the SLO correction belongs to.
      - `description` string — Description of the correction being made.
      - `duration` integer — Length of time (in seconds) for a specified `rrule` recurring SLO correction.
      - `end` integer — Ending time of the correction in epoch seconds.
      - `rrule` string — The recurrence rules as defined in the iCalendar RFC 5545. The supported rules for SLO corrections are `FREQ`, `INTERVAL`, `COUNT`, `UNTIL` and `BYDAY`.
      - `slo_id` string — ID of the single SLO that this correction applies to.
      - `slo_query` string — Query that matches the SLOs this correction applies to. The query uses the [Events search syntax](https://docs.datadoghq.com/events/explorer/searching/) and can filter SLOs by SLO tags.
      - `start` integer, required — Starting time of the correction in epoch seconds.
      - `timezone` string — The timezone to display in the UI for the correction times (defaults to "UTC").
    - `type` 'correction', required — SLO correction resource type.

## Response `200`

OK

- SLOCorrectionResponse — The response object of an SLO correction.
  - `data` SLOCorrection — The response object of a list of SLO corrections.
    - `attributes` SLOCorrectionResponseAttributes — The attribute object associated with the SLO correction.
      - `category` 'Scheduled Maintenance' | 'Outside Business Hours' | 'Deployment' | 'Other' — Category the SLO correction belongs to.
      - `created_at` integer, nullable — The epoch timestamp of when the correction was created at.
      - `creator` Creator — Object describing the creator of the shared element.
        - `email` string — Email of the creator.
        - `handle` string — Handle of the creator.
        - `name` string, nullable — Name of the creator.
      - `description` string — Description of the correction being made.
      - `duration` integer, nullable — Length of time (in seconds) for a specified `rrule` recurring SLO correction.
      - `end` integer, nullable — Ending time of the correction in epoch seconds.
      - `modified_at` integer, nullable — The epoch timestamp of when the correction was modified at.
      - `modifier` SLOCorrectionResponseAttributesModifier, nullable — Modifier of the object.
        - `email` string — Email of the Modifier.
        - `handle` string — Handle of the Modifier.
        - `name` string — Name of the Modifier.
      - `rrule` string, nullable — The recurrence rules as defined in the iCalendar RFC 5545. The supported rules for SLO corrections are `FREQ`, `INTERVAL`, `COUNT`, `UNTIL` and `BYDAY`.
      - `slo_id` string, nullable — ID of the single SLO that this correction applies to.
      - `slo_query` string, nullable — Query that matches the SLOs this correction applies to.
      - `start` integer — Starting time of the correction in epoch seconds.
      - `timezone` string — The timezone to display in the UI for the correction times (defaults to "UTC").
    - `id` string — The ID of the SLO correction.
    - `type` 'correction' — SLO correction resource type.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — SLO Not Found
- `429` — Too many requests

---

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