Set or update a spend budget

Caps how much an organization can spend on one of your LLM keys. When the organization’s spend reaches the limit, the gateway stops using that key for the organization until the budget is raised or reset. Creates the budget, or replaces the existing one.

Only partner owners and admins can set budgets, and budgets are supported on metered LLM keys (Anthropic today).

POST /partner/orgs/{orgId}/secrets/{secretId}/budget

Set or update a spend budget

cURL

curl --request POST \
  --url https://api.onecli.sh/v1/partner/orgs/{orgId}/secrets/{secretId}/budget \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limitCents": 500
}
'

import requests

url = "https://api.onecli.sh/v1/partner/orgs/{orgId}/secrets/{secretId}/budget"

payload = { "limitCents": 500 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({limitCents: 500})
};

fetch('https://api.onecli.sh/v1/partner/orgs/{orgId}/secrets/{secretId}/budget', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.onecli.sh/v1/partner/orgs/{orgId}/secrets/{secretId}/budget",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'limitCents' => 500
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.onecli.sh/v1/partner/orgs/{orgId}/secrets/{secretId}/budget"

	payload := strings.NewReader("{\n  \"limitCents\": 500\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.onecli.sh/v1/partner/orgs/{orgId}/secrets/{secretId}/budget")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limitCents\": 500\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.onecli.sh/v1/partner/orgs/{orgId}/secrets/{secretId}/budget")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"limitCents\": 500\n}"

response = http.request(request)
puts response.read_body

200

{
  "secretId": "<string>",
  "organizationId": "<string>",
  "limitCents": 500,
  "spentCents": 320
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

Authorization · string · header · required

API key obtained from the dashboard or GET /user/api-key

Path Parameters

orgId · string · required

secretId · string · required

Body

application/json

limitCents · integer · required

Spend ceiling in US cents (e.g. 500 = $5.00).

Required range: 1 <= x <= 100000000

Example:

500

period · enum<string> · required

monthly resets on the 1st of each month (UTC); total is a one-time lifetime cap.

Available options: monthly, total

Response

200

application/json

Budget saved

secretId · string

The partner LLM key this budget caps.

organizationId · string

limitCents · integer

Spend ceiling in US cents (e.g. 500 = $5.00).

Example:

500

period · enum<string>

Available options: monthly, total

spentCents · integer

Spend so far this period, in US cents. Updates within a few seconds of usage.

Example:

320