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

# UpdateLogScaleAction



## OpenAPI

````yaml openapi/api_v1_config_openapi3_DOCUMENTATION_ONLY.json PUT /api/v1/config/log-scale-actions/{slug}
openapi: 3.0.3
info:
  description: >

    The Config API provides standard HTTP/JSON REST endpoints for creating,
    reading,

    updating, deleting, and listing configurable Chronosphere resources.


    Use this link to download the raw Swagger specification:

    <a href="/api/v1/config/swagger.json">/api/v1/config/swagger.json</a>
  title: Config V1 API
  version: v1
servers:
  - url: https://{tenant}.chronosphere.io
    variables:
      tenant:
        default: tenant
        description: tenant ID assigned by the service provider
security:
  - ApiKeyAuth: []
tags:
  - name: ConfigV1
paths:
  /api/v1/config/log-scale-actions/{slug}:
    put:
      tags:
        - LogScaleAction
      operationId: UpdateLogScaleAction
      parameters:
        - in: path
          name: slug
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfigV1UpdateLogScaleActionBody'
        required: true
        x-originalParamName: body
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/configv1UpdateLogScaleActionResponse'
          description: A successful response containing the updated LogScaleAction.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: Cannot update the LogScaleAction because the request is invalid.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: Cannot update the LogScaleAction because the slug does not exist.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: >-
            Cannot update the LogScaleAction because there is a conflict with an
            existing LogScaleAction.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: An unexpected error response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/genericError'
          description: An undefined error response.
components:
  schemas:
    ConfigV1UpdateLogScaleActionBody:
      properties:
        create_if_missing:
          description: >-
            If `true`, the LogScaleAction will be created if it does not already
            exist, identified by `slug`. If `false`, an error will be returned
            if the LogScaleAction does not already exist.
          type: boolean
        dry_run:
          description: >-
            If `true`, validates the specified configuration without creating or
            updating the LogScaleAction. If the specified configuration is
            valid, the endpoint returns a partial response without the
            LogScaleAction. If the specified configuration is invalid, the
            endpoint returns an error.
          type: boolean
        log_scale_action:
          allOf:
            - $ref: '#/components/schemas/configv1LogScaleAction'
          description: The LogScaleAction to update.
      type: object
    configv1UpdateLogScaleActionResponse:
      properties:
        log_scale_action:
          $ref: '#/components/schemas/configv1LogScaleAction'
      type: object
    apiError:
      properties:
        message:
          description: An error message describing what went wrong.
          type: string
      type: object
    genericError:
      additionalProperties: true
      type: object
    configv1LogScaleAction:
      properties:
        action_type:
          $ref: '#/components/schemas/LogScaleActionActionType'
        created_at:
          description: >-
            Timestamp of when the LogScaleAction was created. Cannot be set by
            clients.
          format: date-time
          readOnly: true
          type: string
        email_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionEmailAction'
          description: Data for creating an email action.
        humio_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionHumioRepoAction'
          description: Data for creating a LogScale repository action.
        name:
          description: Name of an action.
          type: string
        ops_genie_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionOpsGenieAction'
          description: Data for creating an OpsGenie action.
        pager_duty_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionPagerDutyAction'
          description: Data for creating a PagerDuty action.
        repository:
          description: Name of the LogScale repository the alerts belongs to. Required.
          type: string
        slack_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionSlackAction'
          description: Data for creating a Slack action.
        slack_post_message_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionSlackPostMessageAction'
          description: Data for creating a post message Slack action.
        slug:
          description: >-
            The unique identifier of the LogScaleAction. If a `slug` isn't
            provided, one is generated based on the `name` field. You can't
            modify this field after the LogScaleAction is created.
          type: string
        updated_at:
          description: >-
            Timestamp of when the LogScaleAction was last updated. Cannot be set
            by clients.
          format: date-time
          readOnly: true
          type: string
        upload_file_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionUploadFileAction'
          description: Data for creating an upload file action.
        victor_ops_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionVictorOpsAction'
          description: Data for creating a VictorOps action.
        webhook_action:
          allOf:
            - $ref: '#/components/schemas/LogScaleActionWebhookAction'
          description: Data for creating a webhook action.
      required:
        - name
      type: object
    LogScaleActionActionType:
      enum:
        - EMAIL
        - HUMIO_REPO
        - OPS_GENIE
        - PAGER_DUTY
        - SLACK
        - SLACK_POST_MESSAGE
        - VICTOR_OPS
        - WEBHOOK
        - UPLOAD_FILE
      type: string
    LogScaleActionEmailAction:
      properties:
        attach_csv:
          description: Whether the result set should be attached as a CSV file.
          type: boolean
        body_template:
          description: >-
            Body of the email. Can be templated with values from the query
            result.
          type: string
        recipients:
          description: List of email addresses to send an email to.
          items:
            type: string
          type: array
        subject_template:
          description: >-
            Subject of the email. Can be templated with values from the query
            result.
          type: string
        use_proxy:
          description: >-
            Defines whether the action should use the configured proxy to make
            web requests.
          type: boolean
      type: object
    LogScaleActionHumioRepoAction:
      properties:
        ingest_token:
          description: Ingest token for the repository that the action should ingest into.
          type: string
      type: object
    LogScaleActionOpsGenieAction:
      properties:
        api_url:
          description: OpsGenie webhook URL to send the request to.
          type: string
        ops_genie_key:
          description: Key to authenticate with OpsGenie.
          type: string
        use_proxy:
          description: >-
            Defines whether the action should use the configured proxy to make
            web requests.
          type: boolean
      type: object
    LogScaleActionPagerDutyAction:
      properties:
        routing_key:
          description: Routing key to authenticate with PagerDuty.
          type: string
        severity:
          allOf:
            - $ref: '#/components/schemas/PagerDutyActionSeverity'
          description: Severity level of the message.
        use_proxy:
          description: >-
            Defines whether the action should use the configured proxy to make
            web requests.
          type: boolean
      type: object
    LogScaleActionSlackAction:
      properties:
        fields:
          additionalProperties:
            type: string
          description: >-
            Fields to include within the Slack message. Can be templated with
            values from the query result.
          type: object
        url:
          description: Slack webhook URL to send the request to.
          type: string
        use_proxy:
          description: >-
            Defines whether the action should use the configured proxy to make
            web requests.
          type: boolean
      type: object
    LogScaleActionSlackPostMessageAction:
      properties:
        api_token:
          description: API token to authenticate with Slack.
          type: string
        channels:
          description: List of Slack channels to message.
          items:
            type: string
          type: array
        fields:
          additionalProperties:
            type: string
          description: >-
            Fields to include within the Slack message. Can be templated with
            values from the query result.
          type: object
        use_proxy:
          description: >-
            Defines whether the action should use the configured proxy to make
            web requests.
          type: boolean
      type: object
    LogScaleActionUploadFileAction:
      properties:
        file_name:
          description: File name for the uploaded file.
          type: string
      type: object
    LogScaleActionVictorOpsAction:
      properties:
        message_type:
          description: Type of the VictorOps message to make.
          type: string
        notify_url:
          description: VictorOps webhook URL to send the request to.
          type: string
        use_proxy:
          description: >-
            Defines whether the action should use the configured proxy to make
            web requests.
          type: boolean
      type: object
    LogScaleActionWebhookAction:
      properties:
        body_template:
          description: >-
            Body of the HTTP or HTTPS request. Can be templated with values from
            the query result.
          type: string
        headers:
          additionalProperties:
            type: string
          description: Headers of the HTTP or HTTPS request.
          type: object
        ignore_ssl:
          description: Flag indicating whether SSL should be ignored for the request.
          type: boolean
        method:
          allOf:
            - $ref: '#/components/schemas/WebhookActionHTTPMethod'
          description: HTTP method to use for the request.
        url:
          description: URL to send the HTTP or HTTPS request to.
          type: string
        use_proxy:
          description: >-
            Defines whether the action should use the configured proxy to make
            web requests.
          type: boolean
      type: object
    PagerDutyActionSeverity:
      enum:
        - CRITICAL
        - ERROR
        - WARNING
        - INFO
      type: string
    WebhookActionHTTPMethod:
      enum:
        - GET
        - POST
        - PUT
        - PATCH
        - DELETE
        - HEAD
        - OPTIONS
      type: string
  securitySchemes:
    ApiKeyAuth:
      description: Chronosphere API token
      in: header
      name: API-Token
      type: apiKey

````