Alerts

Update Alert

Update an existing Alert. You need to provide the Alert ID.

patch/v1/account/{accountSlug}/project/{projectSlug}/alert/{alertId}

Path parameters

accountSlugstring required

Account slug of the user

projectSlugstring required

Project slug of the account

alertIdstring required

Alert Id to get info for

Request body

namestring required

A name of the alert.

descriptionstring

Alert description.

color'#eeeeee' | '#34ace0' | '#ffda79' | '#ff5252' | '#33d9b2'

Hex color indicating the severity of the alert. It can be one of the following severity types:

Default: #eeeeee
Info: #34ace0
Warning: #ffda79
Danger: #ff5252
Success: #33d9b2

Alert type.

enabledboolean

Whether the alert is currently active and monitoring

Example request

{
  "name": "Failed transaction in Contract XYZ",
  "description": "This alert tracks failed transactions on Mainnet",
  "color": "#eeeeee",
  "simple_type": "failed_tx",
  "enabled": true,
  "expressions": [
    {
      "type": "contract_address",
      "expression": {
        "address": "0x94c87a7b26980ae7aaa361c5c7e03e632ab36e6c"
      }
    },
    {
      "type": "network",
      "expression": {
        "network_id": "1"
      }
    },
    {
      "type": "tx_status",
      "expression": {
        "transaction_success": false
      }
    }
  ],
  "delivery_channels": [
    {
      "enabled": true,
      "id": "b16b4b75-e034-44c9-a053-f10d769a1d64"
    },
    {
      "enabled": true,
      "id": "f48f1f9f-1f74-4849-81cf-fce8bd3746b7"
    }
  ]
}

Response

A successful response.

UpdateAlertPatchResponse required

An object with details about updated alert.

Example response

{
  "alert": {
    "id": "510b9e97-5d94-430b-9904-1c6db2a473b2",
    "project_id": "dfdc391a-a15d-4590-9aef-8691259c7df4",
    "name": "Failed transaction in TetherToken",
    "description": "",
    "enabled": true,
    "color": "#ff5252",
    "severity": "danger",
    "created_at": "2023-12-13T12:30:57.416129Z",
    "delivery_channels": [
      {
        "delivery_channel_id": "b16b4b75-e034-44c9-a053-f10d769a1d64",
        "delivery_channel": {
          "id": "b16b4b75-e034-44c9-a053-f10d769a1d64",
          "type": "email",
          "owner_id": "7d5e8b1f-8bf8-4eae-a70f-fb7d354b1cc2",
          "project_id": null,
          "label": "Email: vanja@tenderly.co",
          "reference_id": "vanja@tenderly.co",
          "enabled": true,
          "created_at": "2022-04-13T14:30:10.920586Z",
          "information": {
            "email": "vanja@tenderly.co",
            "emails": [
              "vanja@tenderly.co"
            ]
          }
        },
        "enabled": true,
        "created_at": "2023-12-13T12:31:04.794397Z"
      }
    ],
    "is_editable": true,
    "updated_at": "2023-12-13T12:31:04.799929504Z",
    "expressions": [
      {
        "type": "contract_address",
        "expression": {
          "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "transaction_type": null
        }
      },
      {
        "type": "network",
        "expression": {
          "network_id": "1"
        }
      },
      {
        "type": "tx_status",
        "expression": {
          "transaction_success": false
        }
      }
    ]
  }
}

Changes

Changed in 2 of the 4 revisions of this API.61

Aug 28, 2026e512753e74ce6See the full diff
- ●
  added the new rid:simulation_draft enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new rid:simulation_draft enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new rid:simulation_draft enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new rid:simulation_draft enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new rid:simulation_draft enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new rid:simulation_draft enum value to the // response property for the response status
  response-property-enum-value-added
Jul 31, 202659b67cf882bc1See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history