---
title: "PUT /api/v1/config/log-scale-actions/{slug}"
method: PUT
path: "/api/v1/config/log-scale-actions/{slug}"
tags: ["LogScaleAction"]
---

# PUT /api/v1/config/log-scale-actions/{slug}

`PUT /api/v1/config/log-scale-actions/{slug}`

## Path parameters

- `slug` string, required

## Request body

- ConfigV1UpdateLogScaleActionBody
  - `log_scale_action` Configv1LogScaleAction
    - `slug` string — Unique identifier of the LogScaleAction. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the LogScaleAction is created.
    - `repository` string — Name of the LogScale repository the alerts belongs to. Required.
    - `name` string — Name of an action.
    - `created_at` string, date-time — Timestamp of when the LogScaleAction was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the LogScaleAction was last updated. Cannot be set by clients.
    - `action_type` 'EMAIL' | 'HUMIO_REPO' | 'OPS_GENIE' | 'PAGER_DUTY' | 'SLACK' | 'SLACK_POST_MESSAGE' | 'VICTOR_OPS' | 'WEBHOOK' | 'UPLOAD_FILE'
    - `email_action` LogScaleActionEmailAction
      - `recipients` string[] — List of email addresses to send an email to.
      - `subject_template` string — Subject of the email. Can be templated with values from the query result.
      - `body_template` string — Body of the email. Can be templated with values from the query result.
      - `attach_csv` boolean — Whether the result set should be attached as a CSV file.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `humio_action` LogScaleActionHumioRepoAction
      - `ingest_token` string — Ingest token for the repository that the action should ingest into.
    - `ops_genie_action` LogScaleActionOpsGenieAction
      - `api_url` string — OpsGenie webhook URL to send the request to.
      - `ops_genie_key` string — Key to authenticate with OpsGenie.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `pager_duty_action` LogScaleActionPagerDutyAction
      - `severity` 'CRITICAL' | 'ERROR' | 'WARNING' | 'INFO'
      - `routing_key` string — Routing key to authenticate with PagerDuty.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `slack_action` LogScaleActionSlackAction
      - `url` string — Slack webhook URL to send the request to.
      - `fields` object — Fields to include within the Slack message. Can be templated with values from the query result.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `slack_post_message_action` LogScaleActionSlackPostMessageAction
      - `api_token` string — API token to authenticate with Slack.
      - `channels` string[] — List of Slack channels to message.
      - `fields` object — Fields to include within the Slack message. Can be templated with values from the query result.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `victor_ops_action` LogScaleActionVictorOpsAction
      - `message_type` string — Type of the VictorOps message to make.
      - `notify_url` string — VictorOps webhook URL to send the request to.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `webhook_action` LogScaleActionWebhookAction
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS'
      - `url` string — URL to send the HTTP or HTTPS request to.
      - `headers` object — Headers of the HTTP or HTTPS request.
      - `body_template` string — Body of the HTTP or HTTPS request. Can be templated with values from the query result.
      - `ignore_ssl` boolean — Flag indicating whether SSL should be ignored for the request.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `upload_file_action` LogScaleActionUploadFileAction
      - `file_name` string — File name for the uploaded file.
  - `create_if_missing` boolean — 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.
  - `dry_run` boolean — If true, the LogScaleAction isn't created or updated, and no response LogScaleAction will be returned. The response will return an error if the given LogScaleAction is invalid.

## Response `200`

A successful response containing the updated LogScaleAction.

- Configv1UpdateLogScaleActionResponse
  - `log_scale_action` Configv1LogScaleAction
    - `slug` string — Unique identifier of the LogScaleAction. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the LogScaleAction is created.
    - `repository` string — Name of the LogScale repository the alerts belongs to. Required.
    - `name` string — Name of an action.
    - `created_at` string, date-time — Timestamp of when the LogScaleAction was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the LogScaleAction was last updated. Cannot be set by clients.
    - `action_type` 'EMAIL' | 'HUMIO_REPO' | 'OPS_GENIE' | 'PAGER_DUTY' | 'SLACK' | 'SLACK_POST_MESSAGE' | 'VICTOR_OPS' | 'WEBHOOK' | 'UPLOAD_FILE'
    - `email_action` LogScaleActionEmailAction
      - `recipients` string[] — List of email addresses to send an email to.
      - `subject_template` string — Subject of the email. Can be templated with values from the query result.
      - `body_template` string — Body of the email. Can be templated with values from the query result.
      - `attach_csv` boolean — Whether the result set should be attached as a CSV file.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `humio_action` LogScaleActionHumioRepoAction
      - `ingest_token` string — Ingest token for the repository that the action should ingest into.
    - `ops_genie_action` LogScaleActionOpsGenieAction
      - `api_url` string — OpsGenie webhook URL to send the request to.
      - `ops_genie_key` string — Key to authenticate with OpsGenie.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `pager_duty_action` LogScaleActionPagerDutyAction
      - `severity` 'CRITICAL' | 'ERROR' | 'WARNING' | 'INFO'
      - `routing_key` string — Routing key to authenticate with PagerDuty.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `slack_action` LogScaleActionSlackAction
      - `url` string — Slack webhook URL to send the request to.
      - `fields` object — Fields to include within the Slack message. Can be templated with values from the query result.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `slack_post_message_action` LogScaleActionSlackPostMessageAction
      - `api_token` string — API token to authenticate with Slack.
      - `channels` string[] — List of Slack channels to message.
      - `fields` object — Fields to include within the Slack message. Can be templated with values from the query result.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `victor_ops_action` LogScaleActionVictorOpsAction
      - `message_type` string — Type of the VictorOps message to make.
      - `notify_url` string — VictorOps webhook URL to send the request to.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `webhook_action` LogScaleActionWebhookAction
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS'
      - `url` string — URL to send the HTTP or HTTPS request to.
      - `headers` object — Headers of the HTTP or HTTPS request.
      - `body_template` string — Body of the HTTP or HTTPS request. Can be templated with values from the query result.
      - `ignore_ssl` boolean — Flag indicating whether SSL should be ignored for the request.
      - `use_proxy` boolean — Defines whether the action should use the configured proxy to make web requests.
    - `upload_file_action` LogScaleActionUploadFileAction
      - `file_name` string — File name for the uploaded file.

## Other responses

- `400` — Cannot update the LogScaleAction because the request is invalid.
- `404` — Cannot update the LogScaleAction because the slug does not exist.
- `409` — Cannot update the LogScaleAction because there is a conflict with an existing LogScaleAction.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.net/chronosphere/apis/config-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/config-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/config-v1-api/versions/530951bd2ccf/schema)