OverviewPlatformsAPI Reference
Alerts

Update a channel

PATCH
/v1/channels/{id}

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Path Parameters

idstring

Channel id (dest_...).

Length1 <= length

Request Body

label?string
Length1 <= length <= 80
url?string

Webhooks only.

Formaturi
headers?

Webhooks only; replaces the whole set.

events?array<string>

Replaces the whole set of account events the channel receives. A webhook takes any of them; a Slack, email or Telegram channel the attention events only (mention.spike, sentiment.negative_spike, keyword.noisy, channel.failing, feed.failing, feed.recovered). An empty list unsubscribes it from all of them.

Itemsitems <= 12

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.mentio.dev/v1/channels/dest_abc123" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "label": "string",
  "stats": {
    "alerts": 0,
    "activeAlerts": 0,
    "lastDeliveryAt": "string",
    "last7d": {
      "total": 0,
      "failed": 0
    }
  },
  "createdAt": "string",
  "kind": "slack",
  "config": {
    "channelId": "string",
    "channelName": "string",
    "events": [
      "mention.spike"
    ]
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Update an alert PATCH

Previous Page

Mentions grouped by one dimension GET

One table of matched, relevant and sentiment counts grouped by `by`: platform, keyword, sentiment, intent, status, hour (weekday and hour of day) or person. The window is `range` (7d, 30d, 90d, 365d, ending today) or `from` and `to`, cut into days in `timezone` (UTC by default); `keywordIds` and `platforms` narrow it; `compare=true` adds the period of the same length right before it. Time axis is the publish date.