---
title: "Update Ecosystem Incident Subscription"
method: PATCH
path: "/v0/platform/ecosystem-incidents/subscriptions/{id}"
tags: ["Ecosystem Incident Subscriptions"]
---

# Update Ecosystem Incident Subscription

`PATCH /v0/platform/ecosystem-incidents/subscriptions/{id}`

Change a subscription's name or actions.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string — Updated subscription name.
  - `actions` EcosystemIncidentSubscriptionAction[] — Replacement list of delivery actions with match criteria.
    - `action` union, required — Delivery action (same schema as monitor actions).
      - EmailAction
        - `type` 'email', required — Action type.
        - `severity` Severity[] — Incident severities this action runs for. When omitted, null, or an empty list, the action runs for incidents of any severity. Must not contain duplicate values.
        - `to` string[], required — Primary email recipients.
        - `cc` string[] — CC email recipients.
        - `bcc` string[] — BCC email recipients.
        - `body` string — Request body payload.
      - SlackAction
        - `type` 'slack', required — Action type.
        - `severity` Severity[] — Incident severities this action runs for. When omitted, null, or an empty list, the action runs for incidents of any severity. Must not contain duplicate values.
        - `integration_instance_id` string, required — Identifier for the integration instance.
        - `channels` string[], required — Slack channel names
        - `message_format` string — Customization of the message to send in the Slack notification.
      - TelegramAction
        - `type` 'telegram', required — Action type.
        - `severity` Severity[] — Incident severities this action runs for. When omitted, null, or an empty list, the action runs for incidents of any severity. Must not contain duplicate values.
        - `integration_instance_id` string, required — Identifier for the integration instance.
        - `chats` object[], required — Telegram chat and topic configuration for posting notifications.
          - `chat_id` string, required — Telegram channel ID.
          - `topic_ids` integer[] — Optional topic IDs within the channel where the message should be posted.
        - `message_format` string — Customization of the message to send in the Telegram notification.
    - `match` EcosystemIncidentSubscriptionMatch — Per-action incident match criteria. Severity is set on the action's own severity field.
      - `monitor_type` string[] — Monitor types this action matches (any of). Omit for all. A null incident monitor_type matches only when this is omitted.
      - `chains` string[] — Chain identifiers this action requires (e.g. ethereum, base). Multiple values are AND-ed on one action; use separate actions to match either chain.
      - `funds_lost_min` number — Minimum funds lost (USD). Omit for no threshold.

## Response `200`

- EcosystemIncidentSubscription
  - `id` string, required — Unique subscription identifier.
  - `name` string, required — Human-readable subscription name.
  - `actions` EcosystemIncidentSubscriptionAction[], required
    - `action` union, required — Delivery action (same schema as monitor actions).
      - EmailAction
        - `type` 'email', required — Action type.
        - `severity` Severity[] — Incident severities this action runs for. When omitted, null, or an empty list, the action runs for incidents of any severity. Must not contain duplicate values.
        - `to` string[], required — Primary email recipients.
        - `cc` string[] — CC email recipients.
        - `bcc` string[] — BCC email recipients.
        - `body` string — Request body payload.
      - SlackAction
        - `type` 'slack', required — Action type.
        - `severity` Severity[] — Incident severities this action runs for. When omitted, null, or an empty list, the action runs for incidents of any severity. Must not contain duplicate values.
        - `integration_instance_id` string, required — Identifier for the integration instance.
        - `channels` string[], required — Slack channel names
        - `message_format` string — Customization of the message to send in the Slack notification.
      - TelegramAction
        - `type` 'telegram', required — Action type.
        - `severity` Severity[] — Incident severities this action runs for. When omitted, null, or an empty list, the action runs for incidents of any severity. Must not contain duplicate values.
        - `integration_instance_id` string, required — Identifier for the integration instance.
        - `chats` object[], required — Telegram chat and topic configuration for posting notifications.
          - `chat_id` string, required — Telegram channel ID.
          - `topic_ids` integer[] — Optional topic IDs within the channel where the message should be posted.
        - `message_format` string — Customization of the message to send in the Telegram notification.
    - `match` EcosystemIncidentSubscriptionMatch — Per-action incident match criteria. Severity is set on the action's own severity field.
      - `monitor_type` string[] — Monitor types this action matches (any of). Omit for all. A null incident monitor_type matches only when this is omitted.
      - `chains` string[] — Chain identifiers this action requires (e.g. ethereum, base). Multiple values are AND-ed on one action; use separate actions to match either chain.
      - `funds_lost_min` number — Minimum funds lost (USD). Omit for no threshold.
  - `created_by` string, required
  - `updated_by` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

---

[API](https://skmtc.net/blockaid-official/apis/blockaid-api.md) · [All operations](https://skmtc.net/blockaid-official/apis/blockaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockaid-official/blockaid-api/versions/17c41f337b2e/schema)