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

CreateObjective

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

Execution Availability

Try It Out

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

Request Inputs

Body Fields

  • nameStringRequired

    Human-readable name for the new SLO objective.

    Example: api-availability-99.9

  • sliIdStringRequired

    Identifier of the SLI this objective is based on.

    Example: sli-abc123

  • targetLongRequired

    Target compliance ratio (0.0–1.0).

    Example: 0.999

  • windowStringRequired

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

    Example: 30d

  • tenantIdStringRequired

    Tenant that will own this SLO objective.

    Example: tenant-001

Responses

200 OK

On success, this API returns the following response structure.

  • idString

    Unique identifier of the SLO objective.

    Example: slo-xyz789

  • nameString

    Human-readable name of the SLO objective.

    Example: api-availability-99.9

  • sliIdString

    Identifier of the SLI this objective is based on.

    Example: sli-abc123

  • targetLong

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

    Example: 0.999

  • windowString

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

    Example: 30d

  • tenantIdString

    Tenant that owns this SLO objective.

    Example: tenant-001

  • alertOnBurnRateBoolean

    Whether to trigger alerts when the burn rate exceeds thresholds.

    Example: true

  • ownerTeamString

    Team responsible for maintaining this SLO.

    Example: platform-infra

  • createdAtString

    Timestamp when this SLO objective was created.

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

Endpoint

POST/api/v1/slo/objectives

/api/v1/slo/objectives

Operation ID

CreateObjective

Permalink

Request Example

curl -X POST '{host}/api/v1/slo/objectives' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"name":"api-availability-99.9","sliId":"sli-abc123","target":0.999,"window":"30d","tenantId":"tenant-001","alertOnBurnRate":true,"ownerTeam":"platform-infra"}'

Response Example

200
{
  "id": "slo-xyz789",
  "name": "api-availability-99.9",
  "sliId": "sli-abc123",
  "target": 0.999,
  "window": "30d",
  "tenantId": "tenant-001",
  "alertOnBurnRate": true,
  "ownerTeam": "platform-infra"
}

Change History

This API has no change history records yet.

View all change history