Справочник API публикуется на английском языке.
Refresh a status card
/api/status-cards/{id}/refreshRefresh a status card.
Queues a refresh; it does not return a new summary. The card's summarizer agent writes the update in its own generation run, after which the card's lastGeneratedAt and summary change. Do not sleep or poll for it: reply now that the refresh is queued, with the returned card.href as a Markdown link where the person sees the update. alreadyGenerating means an earlier refresh is still running. enqueued false without alreadyGenerating means this request started no run: if card.lastGeneratedAt is newer than before your request, a concurrent refresh already finished; otherwise the card's refresh policy deferred it, and card.state says why (such as paused_budget or paused_hours).
Авторизация
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. Как работают ключи.
Параметры пути
Тело запроса
application/json · обязательно
Ответы
details names each field that failed.Ошибки возвращают {"error": "..."}, часто вместе с code и details. Подробнее: ошибки и ограничения.