Account

Your company's account: who is calling, its keys, its caps, what it spent and the models it may use.

Send Authorization: Bearer vk_test_... on every call. Every route of Account.

GET/v1/limitsThe day and month caps for the company and per user, the alert thresholds and the rate limits.

Your API key, scope runtime or all. On the card: usage. Over HTTP it is made from the contract: fill in every value.

Nothing to send but the route.

Answers 2009 fields

object"limits"Always limits.

Type: "limits"

mode"live" | "test"The mode these limits belong to: the mode of the key in use.

Type: "live" | "test"

org_daily_usdnumber | nullThe company's spending cap per day (UTC), in US dollars, across all its users; null: none, up to the account's ceiling.

Limits: 0 to 1000000.

user_daily_usdnumber | nullThe default cap per user per day (UTC), in US dollars; a user's own spend_cap_usd wins. Null: none.

Limits: 0 to 1000000.

max_org_daily_usdnumberThe highest the company's daily cap may be set, in US dollars. Ask Vestra to raise it.

Limits: 0 to 1000000.

org_monthly_usdnumber | nullThe company's cap per calendar month (UTC), in US dollars. Null (the default): none.

Limits: 0 to 1000000.

user_monthly_usdnumber | nullThe default cap per user per calendar month (UTC), in US dollars; a user's own monthly_cap_usd wins. Null (the default): none.

Limits: 0 to 1000000.

alert_thresholdsinteger[]Percents of a cap at which usage alerts fire, for the company and each user, per day and per month.

Limits: At most 5 items.

rate_limitsobjectHow fast you may call, fixed per account.

requests_per_minuteintegerCalls a key may make per minute before 429 rate_limited.

Type: integer

concurrent_task_startsintegerHow many computers your company may be waking at once with warm; past it, warm answers 429 warm_limit. Starting work is not limited by this number yet.

Type: integer

TypeScript

const limits = await vestra.usage.limits();

Python

limits = vestra.usage.limits()

CLI

vestra usage caps

HTTP

No sample in your language for this route, so here it is over HTTP.

curl "$VESTRA_BASE_URL/v1/limits" \  -H "Authorization: Bearer $VESTRA_API_KEY"