OverviewPlatformsAPI Reference
Attention

List attention items

Lists items that need a person, latest first. Kinds are mention.spike (a keyword's mentions jumped in the last hour), sentiment.negative_spike (its 24-hour negative share jumped), keyword.noisy (it turned noisy) and channel.failing (a channel's recent sends all failed). Checks run hourly. Items open when the condition starts and resolve when it ends. Open items are the default, and status=all adds the history. Opening an item also sends an account event of the same name to subscribed webhook, Slack, email and Telegram channels.

GET
/v1/attention

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from POST /v1/api-keys. Keys start with ref_.

In: header

Query Parameters

status?string

Which items to list. Defaults to open.

Default"open"

Value in

  • "open"
  • "resolved"
  • "dismissed"
  • "all"
kind?string

Filters by kind. Send a comma-separated list such as mention.spike,keyword.noisy.

limit?integer

How many items to return, latest first. 50 by default and 100 at most.

Range1 <= value <= 100
Default50
cursor?string

Pass the previous page's nextCursor.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/attention"
{  "data": [    {      "id": "string",      "kind": "mention.spike",      "status": "open",      "subject": {        "type": "keyword",        "id": "string"      },      "title": "string",      "openedAt": "string",      "resolvedAt": "string",      "dismissedAt": "string",      "data": {        "attentionId": "string",        "url": "string",        "keyword": {          "id": "string",          "term": "string",          "kind": "brand",          "name": "string",          "groupId": "string"        },        "window": {          "from": "string",          "to": "string"        },        "matches": 0,        "relevant": 0,        "baseline": {          "meanPerHour": 0,          "stddevPerHour": 0,          "hours": 0        }      }    }  ],  "nextCursor": "string"}
Was this page helpful?

Dismiss an attention item

Dismisses an item. It leaves the open list and stays away while its condition lasts. After the condition ends, a new episode can open a new item. Calling it twice has the same effect as once.

Check the credential

Call this first. It shows the workspace the credential works in, its type (API key, MCP sign-in token or dashboard session), whether it can write, and for keys the id and expiry. A read key gets 403 read_only_key on any write, and scripts often aim at the wrong workspace.