BokaMera.API.Host

<back to all web services

GetAiChatUsage

Requires Authentication
The following routes are available for this service:
GET/assistant/ai-chat/usageGet the AI assistant token usage and limit for a companyReturns how many AI assistant tokens the company has consumed in the current rolling window, the configured limit and whether the company is still within budget. Defaults to the logged-in user's company when no CompanyId is supplied.
GetAiChatUsage Parameters:
NameParameterData TypeRequiredDescription
CompanyIdquerystringNoThe company id. Defaults to the logged-in user's company when omitted.
AiChatUsageResponse Parameters:
NameParameterData TypeRequiredDescription
CompanyIdformGuidNoThe company the usage applies to.
TokensUsedformlongNoTokens consumed within the current rolling window.
TokenLimitformintNoThe company's token limit for the window.
TokensRemainingformlongNoTokens remaining before the limit is reached (never negative).
IsWithinBudgetformboolNoTrue while the company is still below its token limit.
WindowDaysformintNoLength of the rolling usage window, in days.
ResponseStatusformResponseStatusYes

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /assistant/ai-chat/usage HTTP/1.1 
Host: testapi.bokamera.se 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"TokensUsed":0,"TokenLimit":0,"TokensRemaining":0,"IsWithinBudget":false,"WindowDays":0,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}