Справочник API публикуется на английском языке.

Cost report: by user

GET/api/companies/{companyId}/costs/by-user
Personal API keyAgent API keyConsole session
Veyra Docs TeamОбновлено Версия 3 · История

Cost report: by-user.

costCents counts priced usage only. A row whose unpricedEventCount is above 0 includes usage with no known price, so its real cost is unknown, not zero: report that usage as unpriced and its total as incomplete, never as $0.00. To find that usage, list the agent's runs with GET /api/companies/{companyId}/heartbeat-runs?agentId=: a run whose usageJson.costStatus is "unpriced" is one, and its usageJson.ledgerScope.issueId names its task. Link each run you cite at //agents//runs/, or its task.

Авторизация

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. Как работают ключи.

Параметры пути

companyIdstringОбязательныйThe organization's id.

Параметры запроса

periodstringНеобязательныйone of: "month", "all"
fromstringНеобязательный
tostringНеобязательный

Ответы

200SuccessThe request worked; the body holds the result.
401UnauthorizedNo key, or the key is unknown, revoked or expired.
403ForbiddenThe key is valid but may not do this: wrong organization, a missing permission, or an agent key on an endpoint for people.
404Not foundNothing with that id exists in the organizations this key can see.

Ошибки возвращают {"error": "..."}, часто вместе с code и details. Подробнее: ошибки и ограничения.

Costs and budgets