Summarise alert fires
Summarise an alert rule's recent firing pattern with AI: cluster its recent fires by day and return a one-line headline + a few recurring themes, the same 'Summarise with AI' action on the alert-fire detail page. This is a credit-spending action (a real model call) and caches the result per rule for 24h, so a repeat call within the window returns the cached summary for free. It needs at least 3 recent fires (fewer is not enough to find a pattern). It does NOT change the rule or the agent, use update_alert to retune the rule. Only run it when the operator asks to summarise an alert's behaviour.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/summarise_alert_fire" \ -H "Content-Type: application/json" \ -d '{ "alertId": "string", "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Send feedback POST
Report a bug or request a feature to the Vertical AI team. Creates a Linear issue and posts to Slack, the same delivery as the in-app 'Send feedback' widget. Use when the user reports a problem, requests a feature, or wants to send feedback. Fields: type ('bug' | 'feature'), title (short summary), description (the details).
Sync phone number labels POST
Re-derive and write each carrier number's inventory labels (tags + customer_reference) for a workspace from the DB, the source of truth, repairing drift. Numbers bound to an agent get status_live plus customer/ws/agent/env tags; unbound numbers get status_spare. Numbers on any other provider and ones with no provider id are skipped. The assign hook already stamps a number on assignment; run this to fix historical or hand-edited numbers in bulk. Returns a per-number summary. This is the labels-only shortcut: `reconcile_phone_numbers` is the strict superset, it does this label re-stamp AND verifies each number's live voice-connection routing at the carrier and its deletion lock. Use reconcile when you care about routing correctness, this when you only need to repair labels.