Skip to main content
PUT
/
api
/
alerts
/
v1
Update
curl --request PUT \
  --url https://developer.synq.io/api/alerts/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": {
    "fqn": "<string>"
  },
  "name": "<string>",
  "trigger": {
    "parts": [
      {
        "parts": [
          {
            "identifierList": {
              "identifiers": [
                {
                  "airflowDag": {
                    "integrationId": "<string>",
                    "dagId": "<string>"
                  }
                }
              ]
            }
          }
        ]
      }
    ]
  },
  "targets": [
    {
      "email": {
        "recipientEmails": [
          "jsmith@example.com"
        ]
      }
    }
  ],
  "settings": {
    "issue": {
      "ongoing": {
        "disabled": {}
      },
      "severities": [],
      "notifyUpstream": true,
      "allowSqlTestAuditLink": true,
      "grouping": {
        "noGrouping": {}
      }
    }
  }
}
'
{
  "alert": {
    "trigger": {
      "parts": [
        {
          "parts": [
            {
              "identifierList": {
                "identifiers": [
                  {
                    "airflowDag": {
                      "integrationId": "<string>",
                      "dagId": "<string>"
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    },
    "settings": {
      "issue": {
        "ongoing": {
          "disabled": {}
        },
        "severities": [],
        "notifyUpstream": true,
        "allowSqlTestAuditLink": true,
        "grouping": {
          "noGrouping": {}
        }
      }
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "name": "<string>",
    "fqn": "<string>",
    "targets": [
      {
        "email": {
          "recipientEmails": [
            "jsmith@example.com"
          ]
        }
      }
    ],
    "owner": {
      "ownerPath": "<string>",
      "ownershipId": "<string>"
    },
    "isDisabled": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.synq.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

UpdateRequest updates an existing alert configuration. The config can be identified by either ID or FQN. update_request.webhook_incompatible_with_grouped_alerts // Webhook targets are not compatible with grouped alerts. Use the no_grouping strategy when sending alerts to webhook targets. update_request.webhook_incompatible_with_ongoing_alerts // Webhook targets are not compatible with ongoing alert strategies (stream or schedule). Use the disabled ongoing strategy when sending alerts to webhook targets.

​
identifier
fqn · object
required

Identifier for the config to update.

​
name
string | null

Human-readable name for the alert configuration.

Required string length: 1 - 255
​
trigger
EntityGroupQuery · object

Query that defines which entities can trigger this alert.

​
targets
(email · object | ms_teams · object | owner · object | slack · object | webhook · object)[]

Targets where alerts will be sent. Leave empty to keep existing targets.

AlertingTarget represents a destination where alert notifications will be sent. Each target type has its own specific configuration requirements.

​
settings
issue · object

Additional settings for the specific alert type.

Response

200 - application/json

Success

UpdateResponse returns the updated alert configuration.

​
alert
Alert · object
required

The alert configuration that was updated.