Skip to main content
ZStack
SLO & Service Quality/SLO

CreateObjective

Create a new SLO objective linked to an SLI with a target ratio and window.

POST/api/v1/slo/objectives

Operation ID

CreateObjective

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • name
    StringRequired

    Human-readable name for the new SLO objective.

    Example: api-availability-99.9

  • sliId
    StringRequired

    Identifier of the SLI this objective is based on.

    Example: sli-abc123

  • target
    LongRequired

    Target compliance ratio (0.0–1.0).

    Example: 0.999

  • window
    StringRequired

    Rolling compliance window: 7d | 30d | 90d.

    Example: 30d

  • tenantId
    StringRequired

    Tenant that will own this SLO objective.

    Example: tenant-001

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • id
    String

    Unique identifier of the SLO objective.

    Example: slo-xyz789

  • name
    String

    Human-readable name of the SLO objective.

    Example: api-availability-99.9

  • sliId
    String

    Identifier of the SLI this objective is based on.

    Example: sli-abc123

  • target
    Long

    Target compliance ratio (0.0–1.0), e.g. 0.999 for 99.9%.

    Example: 0.999

  • window
    String

    Rolling compliance window: 7d | 30d | 90d.

    Example: 30d

  • tenantId
    String

    Tenant that owns this SLO objective.

    Example: tenant-001

  • alertOnBurnRate
    Boolean

    Whether to trigger alerts when the burn rate exceeds thresholds.

    Example: true

  • ownerTeam
    String

    Team responsible for maintaining this SLO.

    Example: platform-infra

  • createdAt
    String

    Timestamp when this SLO objective was created.

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