Skip to main content
API Explorer|API Explorer
SLO & Service Quality/SLO
POSTSLOSince 1.0SynchronousAuth Required

CreateOverride

Create a temporary target override for an SLO objective with a validity window.

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Request Inputs

Path Parameters

  • sloIdStringRequired

    Identifier of the SLO objective to override.

Body Fields

  • overrideTargetLongRequired

    Temporary target ratio to apply during the override window.

    Example: 0.95

  • startAtStringRequired

    Start time of the override window.

    Example: 2026-01-15T08:00:00Z

  • endAtStringRequired

    End time of the override window.

    Example: 2026-01-15T08:00:00Z

  • reasonStringRequired

    Business justification for the override.

    Example: Planned maintenance window for DB upgrade

Responses

200 OK

On success, this API returns the following response structure.

  • idString

    Unique identifier of this override record.

    Example: ovr-001

  • sloIdString

    Identifier of the SLO objective being overridden.

    Example: slo-xyz789

  • overrideTargetLong

    Temporary target ratio that replaces the default target during the override window.

    Example: 0.95

  • startAtString

    Timestamp when the override becomes effective.

    Example: 2026-01-15T08:00:00Z

  • endAtString

    Timestamp when the override expires.

    Example: 2026-01-15T08:00:00Z

  • reasonString

    Business justification for applying this override.

    Example: Planned maintenance window for DB upgrade

Endpoint

POST/api/v1/slo/objectives/{sloId}/overrides

/api/v1/slo/objectives/{sloId}/overrides

Operation ID

CreateOverride

Permalink

Request Example

curl -X POST '{host}/api/v1/slo/objectives/{sloId}/overrides' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"overrideTarget":0.95,"startAt":"2026-01-15T08:00:00Z","endAt":"2026-01-15T08:00:00Z","reason":"Planned maintenance window for DB upgrade"}'

Response Example

200
{
  "id": "ovr-001",
  "sloId": "slo-xyz789",
  "overrideTarget": 0.95,
  "startAt": "example",
  "endAt": "example",
  "reason": "Planned maintenance window for DB upgrade"
}

Change History

This API has no change history records yet.

View all change history