> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coralogix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Replace Slo

> No description available



## OpenAPI

````yaml openapi_v3.yaml put /v1/slo/slos
openapi: 3.0.0
info:
  title: ''
  version: 1.0.0
servers:
  - url: https://api.coralogix.com/mgmt/openapi/3
  - url: https://api.eu2.coralogix.com/mgmt/openapi/3
  - url: https://api.coralogix.us/mgmt/openapi/3
  - url: https://api.cx498.coralogix.com/mgmt/openapi/3
  - url: https://api.coralogix.in/mgmt/openapi/3
  - url: https://api.coralogixsg.com/mgmt/openapi/3
  - url: https://api.ap3.coralogix.com/mgmt/openapi/3
security:
  - apiKeyAuth: []
tags:
  - name: Alert definitions service
    description: >-
      View and manage your alerts using alert definitions - data structures that
      contain the configuration required to create an alert.
    externalDocs:
      description: Learn more about alerts in our documentation
      url: https://coralogix.com/docs/user-guides/alerting/introduction-to-alerts/
  - name: Metrics Data Archive Service
    description: View and manage your storage targets for metrics.
    externalDocs:
      description: Find out more about archives
      url: >-
        https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive/
  - name: Connectors service
    description: >-
      View and manage your connectors - integration instances for notification
      destinations
    externalDocs:
      description: Lean more about connectors in our documentation
      url: >-
        https://coralogix.com/docs/user-guides/notification-center/connectors/introduction/
  - name: Cases service
    description: >-
      Manage cases throughout their lifecycle. Create, view, assign,
      acknowledge, resolve, and close cases to streamline investigations and
      follow-ups.
    externalDocs:
      description: Learn more about Cases in our documentation
      url: https://coralogix.com/docs/user-guides/cases/
  - name: SAML Configuration Service
    description: Manage your SAML configuration
    externalDocs:
      url: ''
  - name: Events2Metrics Service
    description: Manage your events2metrics.
    externalDocs:
      url: ''
  - name: Presets service
    description: >-
      View and manage your presets - pre-configured templates for notification
      content rendering
    externalDocs:
      description: Lean more about presets in our documentation
      url: >-
        https://coralogix.com/docs/user-guides/notification-center/presets/introduction/
  - name: Entities service
    description: Query information about registered entities in the notification center
    externalDocs:
      description: Lean more about the notification center in our documentation
      url: https://coralogix.com/docs/user-guides/notification-center/introduction/
  - name: API Keys Service
    description: Manage your API Keys.
    externalDocs:
      url: ''
  - name: Alert events service
    description: >-
      Get information regarding your alert events - instances of alerts being
      triggered.
    externalDocs:
      description: Learn more about alert events and incidents in our documentation.
      url: https://coralogix.com/docs/user-guides/alerting/incidents/
  - name: Scopes Service
    description: A service to manage scopes
    externalDocs:
      url: ''
  - name: IP access service
    description: >-
      IP access service provides the API for managing company IP access
      settings.
    externalDocs:
      url: ''
  - name: Dashboard service
    description: Get information about the Coralogix Dashboard catalog.
    externalDocs:
      url: ''
  - name: Events Service
    description: A service for querying events.
    externalDocs:
      description: Learn more about alerts in our documentation
      url: https://coralogix.com/docs/user-guides/alerting/introduction-to-alerts/
  - name: Team Permissions Management Service
    description: Manage Team Groups.
    externalDocs:
      url: ''
  - name: Extension service
    description: A service that enables querying for extension information.
    externalDocs:
      description: Learn more about extensions in our documentation.
      url: https://coralogix.com/docs/integrations/extensions/
  - name: Extension testing service
    externalDocs:
      description: Find out more about extensions in our documentation.
      url: https://coralogix.com/docs/integrations/extensions/
  - name: Data Usage Service
    description: A service to manage data usage metrics.
    externalDocs:
      url: ''
  - name: Target Service
    description: View and manage your storage targets for logs.
    externalDocs:
      description: Find out more about archives
      url: >-
        https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive/
  - name: Contextual data integration service
    description: Query for contextual data integration information.
    externalDocs:
      url: ''
  - name: Custom Enrichments Service
    description: Manage your enrichments.
    externalDocs:
      url: ''
  - name: Global routers service
    description: >-
      View and manage your global routers - entities that direct notifications
      to configured destinations based on conditions
    externalDocs:
      description: Lean more about global routers in our documentation
      url: >-
        https://coralogix.com/docs/user-guides/notification-center/routing/introduction/
  - name: Recording Rules Service
    description: A service to manage recording rules.
    externalDocs:
      url: ''
  - name: Folders for views service
    description: Create and manage view folders.
    externalDocs:
      url: ''
  - name: Incidents service
    description: >-
      Handle all operations related to incident management within Coralogix.
      Identify, manage, and resolve incidents efficiently through automated
      workflows and team collaboration.
    externalDocs:
      description: Find out more about incident management in our documentation
      url: https://coralogix.com/docs/user-guides/alerting/incidents/
  - name: Retentions Service
    description: View and manage retentions
    externalDocs:
      url: ''
  - name: Extension deployment service
    description: A service that enables querying for extension deployment information.
    externalDocs:
      description: Find out more about extensions in our documentation.
      url: https://coralogix.com/docs/integrations/extensions/
  - name: Enrichments Service
    description: Manage your enrichments.
    externalDocs:
      url: ''
  - name: Role Management Service
    description: Service for managing system and custom roles.
    externalDocs:
      url: ''
  - name: Integration service
    description: A service that enables querying for integration information.
    externalDocs:
      description: Find out more about integrations in our documentation.
      url: https://coralogix.com/docs/integrations/getting-started/
  - name: Rule Groups Service
    description: A service to manage rule groups.
    externalDocs:
      url: ''
  - name: Policies Service
    description: View and manage your TCO policies
    externalDocs:
      url: ''
  - name: Alert Scheduler Rule service
    description: Manage your alert scheduler rules.
    externalDocs:
      url: ''
  - name: Dashboard folders service
    description: Manage your dashboard folders.
    externalDocs:
      url: ''
  - name: Actions Service
    description: A service for managing actions.
    externalDocs:
      url: ''
  - name: Slos Service
    description: A service for managing Service Level Objectives (SLOs).
    externalDocs:
      url: ''
  - name: Views service
    description: Create and manage views.
    externalDocs:
      url: ''
  - name: Outgoing webhooks service
    externalDocs:
      description: Find out more about outbound webhooks in our documentation.
      url: >-
        https://coralogix.com/docs/user-guides/alerting/outbound-webhooks/generic-outbound-webhooks-alert-webhooks/
  - name: SLO Service
    description: Manage your SLOs.
    externalDocs:
      url: ''
paths:
  /v1/slo/slos:
    put:
      tags:
        - Slos Service
      summary: Replace Slo
      description: No description available
      operationId: SlosService_ReplaceSlo
      parameters:
        - in: query
          name: silence_data_validations
          required: false
          schema:
            type: boolean
            deprecated: true
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
                - $ref: '#/components/schemas/SloRequestBasedMetricSli'
                - $ref: '#/components/schemas/SloWindowBasedMetricSli'
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReplaceSloResponse'
          description: ''
        '400':
          content:
            application/json: {}
          description: Bad Request
        '401':
          content:
            application/json: {}
          description: Unauthorized request
        '500':
          content:
            application/json: {}
          description: Internal server error
      externalDocs:
        url: ''
components:
  schemas:
    SloRequestBasedMetricSli:
      title: Slo
      required:
        - name
        - targetThresholdPercentage
        - window
        - sli
      type: object
      properties:
        createTime:
          type: string
          format: date-time
        creator:
          type: string
          example: test@domain.com
        description:
          type: string
          example: A brief description of my SLO
        grouping:
          $ref: '#/components/schemas/v1.Grouping'
        id:
          type: string
          example: b11919d5-ef85-4bb1-8655-02640dbe94d9
        labels:
          type: object
          additionalProperties:
            type: string
        name:
          type: string
          example: Example Slo Name
        requestBasedMetricSli:
          $ref: '#/components/schemas/RequestBasedMetricSli'
        revision:
          $ref: '#/components/schemas/v1.Revision'
        sloTimeFrame:
          $ref: '#/components/schemas/SloTimeFrame'
        targetThresholdPercentage:
          type: number
          format: float
          example: 99.999
        type:
          type: string
          example: request
        updateTime:
          type: string
          format: date-time
      additionalProperties: false
      description: Definition of an SLO
      externalDocs:
        url: ''
    SloWindowBasedMetricSli:
      title: Slo
      required:
        - name
        - targetThresholdPercentage
        - window
        - sli
      type: object
      properties:
        createTime:
          type: string
          format: date-time
        creator:
          type: string
          example: test@domain.com
        description:
          type: string
          example: A brief description of my SLO
        grouping:
          $ref: '#/components/schemas/v1.Grouping'
        id:
          type: string
          example: b11919d5-ef85-4bb1-8655-02640dbe94d9
        labels:
          type: object
          additionalProperties:
            type: string
        name:
          type: string
          example: Example Slo Name
        revision:
          $ref: '#/components/schemas/v1.Revision'
        sloTimeFrame:
          $ref: '#/components/schemas/SloTimeFrame'
        targetThresholdPercentage:
          type: number
          format: float
          example: 99.999
        type:
          type: string
          example: request
        updateTime:
          type: string
          format: date-time
        windowBasedMetricSli:
          $ref: '#/components/schemas/WindowBasedMetricSli'
      additionalProperties: false
      description: Definition of an SLO
      externalDocs:
        url: ''
    ReplaceSloResponse:
      title: ReplaceSloResponse
      required:
        - slo
      type: object
      properties:
        effectedSloAlertIds:
          type: array
          items:
            type: string
        slo:
          $ref: '#/components/schemas/Slo'
      description: Response after replacing an existing SLO.
      externalDocs:
        url: ''
    v1.Grouping:
      title: Grouping
      type: object
      properties:
        labels:
          type: array
          items:
            type: string
      description: Definition of the SLO grouping fields
      externalDocs:
        url: ''
    RequestBasedMetricSli:
      title: RequestBasedMetricSli
      required:
        - goodEvents
        - totalEvents
      type: object
      properties:
        goodEvents:
          $ref: '#/components/schemas/Metric'
        totalEvents:
          $ref: '#/components/schemas/Metric'
      description: Definition of a request-based SLI based on metrics
      externalDocs:
        url: ''
    v1.Revision:
      title: Revision
      type: object
      properties:
        revision:
          type: integer
          format: int32
          example: 1
        updateTime:
          type: string
          format: date-time
      description: >-
        The revision of the slo, used to differentiate between different
        versions of the same SLO
      externalDocs:
        url: ''
    SloTimeFrame:
      enum:
        - SLO_TIME_FRAME_UNSPECIFIED
        - SLO_TIME_FRAME_7_DAYS
        - SLO_TIME_FRAME_14_DAYS
        - SLO_TIME_FRAME_21_DAYS
        - SLO_TIME_FRAME_28_DAYS
      type: string
    WindowBasedMetricSli:
      title: WindowBasedMetricSli
      required:
        - query
        - window
        - comparisonOperator
        - threshold
      type: object
      properties:
        comparisonOperator:
          $ref: '#/components/schemas/ComparisonOperator'
        missingDataStrategy:
          $ref: '#/components/schemas/MissingDataStrategy'
        query:
          $ref: '#/components/schemas/Metric'
        threshold:
          type: number
          format: float
          example: 0.95
        window:
          $ref: '#/components/schemas/WindowSloWindow'
      description: Definition of a window-based SLI based on metrics
      externalDocs:
        url: ''
    Slo:
      oneOf:
        - $ref: '#/components/schemas/SloRequestBasedMetricSli'
        - $ref: '#/components/schemas/SloWindowBasedMetricSli'
    Metric:
      title: Metric
      required:
        - query
      type: object
      properties:
        query:
          type: string
          example: sum(rate(http_requests_total{status="200"}[5m]))
      description: Definition of a metric used in SLOs
      externalDocs:
        url: ''
    ComparisonOperator:
      enum:
        - COMPARISON_OPERATOR_UNSPECIFIED
        - COMPARISON_OPERATOR_GREATER_THAN
        - COMPARISON_OPERATOR_GREATER_THAN_OR_EQUALS
        - COMPARISON_OPERATOR_LESS_THAN
        - COMPARISON_OPERATOR_LESS_THAN_OR_EQUALS
      type: string
    MissingDataStrategy:
      enum:
        - MISSING_DATA_STRATEGY_UNCOUNTED
        - MISSING_DATA_STRATEGY_GOOD
        - MISSING_DATA_STRATEGY_BAD
      type: string
    WindowSloWindow:
      enum:
        - WINDOW_SLO_WINDOW_UNSPECIFIED
        - WINDOW_SLO_WINDOW_1_MINUTE
        - WINDOW_SLO_WINDOW_5_MINUTES
      type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key authentication

````