Creation budget may exceed the current wallet balance; it neither adds funds nor guarantees call-time balance. Omitted, null or blank budget_credits means unlimited; a finite budget is a positive exact credit decimal of up to four places within native limits. PATCH has separate validation and may reject a budget exceeding the wallet or below prior spending.
/oneaster/v1/keysAuthorizations
AuthorizationstringrequiredUse a native login access_token (or a scoped PAT where supported); required access: Native access token.
Authorization: Bearer $ONEASTER_ACCESS_TOKEN
Body · application/json
namestringrequired1–50 UTF8 bytes
budget_creditsstring,nullBlank/null/omitted = unlimited; otherwise positive decimal up to four places, exactly representable within native quota bounds. Creation permits a cap above the current wallet balance, including a zero wallet; actual usage remains subject to wallet funds.
modelsarray,nullBlank/empty/null/omitted = all allowed models
expires_atstring,nullJSON Schema
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 50,
"description": "1–50 UTF8 bytes"
},
"budget_credits": {
"type": [
"string",
"null"
],
"description": "Blank/null/omitted = unlimited; otherwise positive decimal up to four places, exactly representable within native quota bounds. Creation permits a cap above the current wallet balance, including a zero wallet; actual usage remains subject to wallet funds."
},
"models": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"maxItems": 50,
"uniqueItems": true,
"description": "Blank/empty/null/omitted = all allowed models"
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
}