#The ChatDisplayMessage is a user-visible chat message for rendering in the UI object

ChatDisplayMessage is a user-visible chat message for rendering in the UI

string

sender

string

"user" or "assistant"

text

string

timestamp

string (date-time)

GET

/v1/analytics/dashboards

Requires auth

#List analytics dashboards

Requires the `analytics:read` scope.

#Parameters

query parameters

linkId

string

query

Restricts the result to the dashboard scoped to this link. Takes precedence over scope when both are set.

scope

string

query

Restricts the result by scope. Unset returns every dashboard.

Allowed values

DASHBOARD_SCOPE_UNSPECIFIED

Every dashboard in the workspace, link-scoped or not.

DASHBOARD_SCOPE_WORKSPACE

Only the workspace-wide dashboard, the one with no link.

DASHBOARD_SCOPE_LINK

Only dashboards tied to a link.

pageSize

integer (int64)

query

Maximum number to return. Defaults to 100, capped at 1000.

pageToken

string

query

Cursor from a previous response's next_page_token. Empty starts at the first page. Pages are ordered by (created_at, id), which never change, so a record cannot move between pages while a client is walking them.

cursor

string

query

Opaque cursor from the previous page's nextPageToken. Same as pageToken; when both are sent, pageToken wins.

#Response

200

Everything worked as expected.

dashboards

array<object>

nextPageToken

string

Cursor to continue listing dashboards. Empty on the last page.

totalCount

integer (int64)

How many records exist in total, so a client can tell a complete answer from a page of one. A local-first client reads absence from this list as deletion, and may only do so when the count it was given matches what it received: without that, one page would look like the whole model and everything beyond it would be removed locally.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/analytics/dashboards?linkId={linkId}&scope={scope}&pageSize={pageSize}&pageToken={pageToken}&cursor={cursor}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "dashboards": [
    {
      "chatMessages": [
        {}
      ],
      "config": {
        "gridColumns": 0,
        "widgets": []
      },
      "createdAt": "2026-10-12T12:16:02.077Z",
      "id": "string",
      "linkId": "string",
      "name": "string",
      "updatedAt": "2026-10-12T12:16:02.077Z"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}

Base URL: https://api.linkbreakers.com

GET

/v1/analytics/dashboards/{dashboardId}/widgets/{widgetId}/summary

Requires auth

Returns the last generated analysis, and whether the underlying values have changed since. Requires the `analytics:read` scope.

path parameters

dashboardId

string

Required

path

widgetId

string

Required

path

200

Everything worked as expected.

result

object

AnalyticsWidgetResult is a generated result for an on-demand widget tab.

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/analytics/dashboards/{dashboardId}/widgets/{widgetId}/summary" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "result": {
    "currentCount": 0,
    "generatedAt": "2026-10-12T12:16:02.077Z",
    "sourceCount": 0,
    "stale": false,
    "text": "string",
    "widgetId": "string"
  }
}

Base URL: https://api.linkbreakers.com

POST

/v1/analytics/dashboards

Requires auth

#Create analytics dashboard

Requires the `analytics:write` scope.

#Parameters

header parameters

Idempotency-Key

string

header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

#Request body

config

object

DashboardConfig is the structured configuration for a dashboard

string

Client-supplied dashboard id. Generated server-side when empty.

linkId

string

Link to scope this dashboard to. Empty creates the workspace-wide dashboard.

name

string

Display name. Defaults to "Default Dashboard" when empty.

useDefaultWidgets

boolean

Fill the dashboard with a starter set instead of leaving it empty, for a dashboard made in one step rather than agreed in a conversation. Without link_id it is the workspace set (scans over time, top links, geography, technology and more). With link_id it is the link set: scans over time, geography, technology, peak hours, and new versus returning visitors, which is everything any link records. The service applies it to any link; whether it suits one is the caller's judgement, since a workflow that collects answers deserves widgets for them. Ignored when config is set, and hidden from the assistant, which agrees its widgets with the user and would otherwise stack them on top of these.

#Response

200

Everything worked as expected.

dashboard

object

AnalyticsDashboard represents a workspace's analytics dashboard

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/dashboards" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  --data '{"config":{"gridColumns":0,"widgets":[{"dataSource":{},"id":"string","position":{},"size":{},"title":"string","visualization":{}}]},"id":"string","linkId":"string","name":"string","useDefaultWidgets":false}'

Sample payload (application/json)

{
  "config": {
    "gridColumns": 0,
    "widgets": [
      {
        "dataSource": {},
        "id": "string",
        "position": {},
        "size": {},
        "title": "string",
        "visualization": {}
      }
    ]
  },
  "id": "string",
  "linkId": "string",
  "name": "string",
  "useDefaultWidgets": false
}

Typical response

{
  "dashboard": {
    "chatMessages": [
      {
        "id": "string",
        "sender": "string",
        "text": "string",
        "timestamp": "2026-10-12T12:16:02.077Z"
      }
    ],
    "config": {
      "gridColumns": 0,
      "widgets": [
        {}
      ]
    },
    "createdAt": "2026-10-12T12:16:02.077Z",
    "id": "string",
    "linkId": "string",
    "name": "string",
    "updatedAt": "2026-10-12T12:16:02.077Z"
  }
}

Base URL: https://api.linkbreakers.com

POST

/v1/analytics/dashboards/{dashboardId}/widgets/{widgetId}/summary

Requires auth

Analyses the widget's current values and stores the result. Consumes platform credits, so it runs only when requested. Requires the `analytics:write` scope.

path parameters

dashboardId

string

Required

path

Dashboard holding the widget

widgetId

string

Required

path

Widget whose values should be analysed

header parameters

Idempotency-Key

string

header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

force

boolean

Regenerate even when the stored result is still current

200

Everything worked as expected.

result

object

AnalyticsWidgetResult is a generated result for an on-demand widget tab.

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/dashboards/{dashboardId}/widgets/{widgetId}/summary" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  --data '{"force":false}'

Sample payload (application/json)

{
  "force": false
}

Typical response

{
  "result": {
    "currentCount": 0,
    "generatedAt": "2026-10-12T12:16:02.078Z",
    "sourceCount": 0,
    "stale": false,
    "text": "string",
    "widgetId": "string"
  }
}

Base URL: https://api.linkbreakers.com

PUT

/v1/analytics/dashboards/{id}

Requires auth

#Update analytics dashboard

Requires the `analytics:write` scope.

#Parameters

path parameters

string

Required

path

ID of the dashboard to update.

header parameters

Idempotency-Key

string

header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

#Request body

config

object

DashboardConfig is the structured configuration for a dashboard

name

string

#Response

200

Everything worked as expected.

dashboard

object

AnalyticsDashboard represents a workspace's analytics dashboard

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X PUT "https://api.linkbreakers.com/v1/analytics/dashboards/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  --data '{"config":{"gridColumns":0,"widgets":[{"dataSource":{},"id":"string","position":{},"size":{},"title":"string","visualization":{}}]},"name":"string"}'

Sample payload (application/json)

{
  "config": {
    "gridColumns": 0,
    "widgets": [
      {
        "dataSource": {},
        "id": "string",
        "position": {},
        "size": {},
        "title": "string",
        "visualization": {}
      }
    ]
  },
  "name": "string"
}

Typical response

{
  "dashboard": {
    "chatMessages": [
      {
        "id": "string",
        "sender": "string",
        "text": "string",
        "timestamp": "2026-10-12T12:16:02.078Z"
      }
    ],
    "config": {
      "gridColumns": 0,
      "widgets": [
        {}
      ]
    },
    "createdAt": "2026-10-12T12:16:02.078Z",
    "id": "string",
    "linkId": "string",
    "name": "string",
    "updatedAt": "2026-10-12T12:16:02.078Z"
  }
}

Base URL: https://api.linkbreakers.com

DELETE

/v1/analytics/dashboards/{id}

Requires auth

#Delete analytics dashboard

Delete a dashboard and its associated assistant conversation. Requires the `analytics:write` scope.

#Parameters

path parameters

string

Required

path

#Response

200

Everything worked as expected.

No structured schema available for this section.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Analytics Dashboard

#The ChatDisplayMessage is a user-visible chat message for rendering in the UI object

#List analytics dashboards

#Parameters

query parameters

Allowed values

#Response

#Error response

#Get a stored widget assistant summary

#Parameters

path parameters

#Response

#Error response

#Create analytics dashboard

#Parameters

header parameters

#Request body

#Response

#Error response

#Generate a widget assistant summary

#Parameters

path parameters

header parameters

#Request body

#Response

#Error response

#Update analytics dashboard

#Parameters

path parameters

header parameters

#Request body

#Response

#Error response

#Delete analytics dashboard

#Parameters

path parameters

#Response

#Error response