v1
/
API
CLI
JS Client

Integrations /

Get notification integration

Get details about a notification integration.

Required permission

Account > Team > Notifications > Read

Path parameters

    • notificationId

      string required
      ID of the notification integration

Response body

  • {object}
    Response object.
    • data

      {object} required
      Result data.
      • name

        string required
        The name of the notification integration.
        min length
        3
        max length
        39
        pattern
        ^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
      • id

        string required
        The ID of the notification integration.
      • type

        string required
        The provider to send webhooks to. `RAW_WEBHOOK` allows you to send webhooks to a url of your choice, or you can choose a specific provider.
        one of
        RAW_WEBHOOK, SLACK, DISCORD, TEAMS
      • webhook

        string required
        The URL where webhooks will be sent.
      • createdAt

        string required
        Creation date
      • updatedAt

        string required
        Last update date
      • status

        {object}
        • disabled

          boolean
          Is the webhook currently disabled?
        • reason

          boolean
          Why the webhook was disabled.
        • timeOfFirstFailedRequest

          string
          The timestamp of the first failed webhook request.
        • numberOfFailedRequests

          number
          The number of failed webhook requests.
      • restricted

        boolean required
        Should notifications be sent only for specific projects?
      • projects

        [array] required
        An array of projects that notifications will be sent for.
        • string
          pattern
          ^[A-Za-z0-9-]+$
      • events

        {object} required
        Which events should notifications be sent for?
        • trigger:service:autoscaling:event

          boolean
        • trigger:service:deployment:status-update

          boolean
        • trigger:addon-backup:start

          boolean
        • trigger:addon-backup:success

          boolean
        • trigger:addon-backup:failure

          boolean
        • trigger:addon-backup:abort

          boolean
        • trigger:build:start

          boolean
        • trigger:build:success

          boolean
        • trigger:build:failure

          boolean
        • trigger:build:abort

          boolean
        • trigger:job-run:start

          boolean
        • trigger:job-run:success

          boolean
        • trigger:job-run:failure

          boolean
        • trigger:job-run:abort

          boolean
        • trigger:job-run:terminate

          boolean
        • trigger:release-flow-template-run:start

          boolean
        • trigger:release-flow-template-run:update

          boolean
        • trigger:release-flow-template-run:success

          boolean
        • trigger:release-flow-template-run:failure

          boolean
        • trigger:release-flow-template-run:aborted

          boolean
        • trigger:template-run:queued

          boolean
        • trigger:template-run:start

          boolean
        • trigger:template-run:update

          boolean
        • trigger:template-run:success

          boolean
        • trigger:template-run:failure

          boolean
        • trigger:resource:certificate-success

          boolean
        • trigger:resource:certificate-final-failure

          boolean
        • trigger:cdn:action-success

          boolean
        • trigger:cdn:action-failure

          boolean
        • trigger:cdn:action-delay

          boolean
        • trigger:log-sink:paused

          boolean
        • trigger:billing:billing-alert-exceeded

          boolean
        • trigger:billing:invoice-payment-action-required

          boolean
        • trigger:billing:invoice-payment-failed

          boolean
        • trigger:billing:invoice-paid

          boolean
        • trigger:billing:invoice-carried-over

          boolean
        • trigger:infrastructure:service:container-crash

          boolean
        • trigger:infrastructure:service:container-eviction

          boolean
        • trigger:infrastructure:addon:container-crash

          boolean
        • trigger:infrastructure:addon:container-eviction

          boolean
        • trigger:infrastructure:job:container-crash

          boolean
        • trigger:infrastructure:job:container-eviction

          boolean
        • trigger:infrastructure:service:container-cpuSpike90

          boolean
        • trigger:infrastructure:service:container-cpuSustained90

          boolean
        • trigger:infrastructure:job:container-cpuSpike90

          boolean
        • trigger:infrastructure:job:container-cpuSustained90

          boolean
        • trigger:infrastructure:addon:container-cpuSpike90

          boolean
        • trigger:infrastructure:addon:container-cpuSustained90

          boolean
        • trigger:infrastructure:service:container-memorySpike90

          boolean
        • trigger:infrastructure:service:container-memorySustained90

          boolean
        • trigger:infrastructure:job:container-memorySpike90

          boolean
        • trigger:infrastructure:job:container-memorySustained90

          boolean
        • trigger:infrastructure:addon-volume:usage-75-exceeded

          boolean
        • trigger:infrastructure:addon-volume:usage-90-exceeded

          boolean
        • trigger:infrastructure:platform-volume:usage-75-exceeded

          boolean
        • trigger:infrastructure:platform-volume:usage-90-exceeded

          boolean
        • trigger:infrastructure:byoc:cluster:error

          boolean
        • trigger:infrastructure:byoc:node-pool:error

          boolean
        • trigger:infrastructure:byoc:scheduling:error

          boolean
API
CLI
JS Client

GET /v1/integrations/notifications/{notificationId}

Example response

200 OK

Details of a notification integration

JSON

{
  "data": {
    "name": "Example Notification",
    "id": "example-notification",
    "type": "RAW_WEBHOOK",
    "webhook": "https://example.com/webhooks",
    "createdAt": "2023-09-12T16:39:44.166Z\"",
    "updatedAt": "2023-09-12T16:39:44.166Z\"",
    "status": {
      "disabled": false
    },
    "restricted": true,
    "projects": [
      "default-project"
    ],
    "events": {
      "trigger:service:autoscaling:event": true,
      "trigger:service:deployment:status-update": true,
      "trigger:addon-backup:start": true,
      "trigger:addon-backup:success": true,
      "trigger:addon-backup:failure": true,
      "trigger:addon-backup:abort": true,
      "trigger:build:start": true,
      "trigger:build:success": true,
      "trigger:build:failure": true,
      "trigger:build:abort": true,
      "trigger:job-run:start": true,
      "trigger:job-run:success": true,
      "trigger:job-run:failure": true,
      "trigger:job-run:abort": true,
      "trigger:job-run:terminate": true,
      "trigger:release-flow-template-run:start": true,
      "trigger:release-flow-template-run:update": true,
      "trigger:release-flow-template-run:success": true,
      "trigger:release-flow-template-run:failure": true,
      "trigger:release-flow-template-run:aborted": true,
      "trigger:template-run:queued": true,
      "trigger:template-run:start": true,
      "trigger:template-run:update": true,
      "trigger:template-run:success": true,
      "trigger:template-run:failure": true,
      "trigger:resource:certificate-success": true,
      "trigger:resource:certificate-final-failure": true,
      "trigger:cdn:action-success": true,
      "trigger:cdn:action-failure": true,
      "trigger:cdn:action-delay": true,
      "trigger:log-sink:paused": true,
      "trigger:billing:billing-alert-exceeded": true,
      "trigger:billing:invoice-payment-action-required": true,
      "trigger:billing:invoice-payment-failed": true,
      "trigger:billing:invoice-paid": true,
      "trigger:billing:invoice-carried-over": true,
      "trigger:infrastructure:service:container-crash": true,
      "trigger:infrastructure:service:container-eviction": true,
      "trigger:infrastructure:addon:container-crash": true,
      "trigger:infrastructure:addon:container-eviction": true,
      "trigger:infrastructure:job:container-crash": true,
      "trigger:infrastructure:job:container-eviction": true,
      "trigger:infrastructure:service:container-cpuSpike90": true,
      "trigger:infrastructure:service:container-cpuSustained90": true,
      "trigger:infrastructure:job:container-cpuSpike90": true,
      "trigger:infrastructure:job:container-cpuSustained90": true,
      "trigger:infrastructure:addon:container-cpuSpike90": true,
      "trigger:infrastructure:addon:container-cpuSustained90": true,
      "trigger:infrastructure:service:container-memorySpike90": true,
      "trigger:infrastructure:service:container-memorySustained90": true,
      "trigger:infrastructure:job:container-memorySpike90": true,
      "trigger:infrastructure:job:container-memorySustained90": true,
      "trigger:infrastructure:addon-volume:usage-75-exceeded": true,
      "trigger:infrastructure:addon-volume:usage-90-exceeded": true,
      "trigger:infrastructure:platform-volume:usage-75-exceeded": true,
      "trigger:infrastructure:platform-volume:usage-90-exceeded": true,
      "trigger:infrastructure:byoc:cluster:error": true,
      "trigger:infrastructure:byoc:node-pool:error": true,
      "trigger:infrastructure:byoc:scheduling:error": true
    }
  }
}

© 2024 Northflank Ltd. All rights reserved.