Update a spend limit

Replaces the value of the existing limit for the product and period. Send exactly one of amount and unlimited: true. The period’s spend is checked at once: raising the limit above the spend lifts the period’s block (evaluation.released), and lowering it below the spend blocks the product (evaluation.blocked_now). Returns 404 when no limit is set; create it instead. With the credential_id query parameter, the request changes that API key’s limit; it needs an amount, and it can be at most the period’s total limit. Lowering the total limit below the period’s highest API key limit is refused.

PATCH

spend_limits

{product}

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const SpendLimit = await client.spendLimits.update('product');

console.log(SpendLimit.data);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
spend_limit = client.spend_limits.update(
    product="product",
)
print(spend_limit.data)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	spendLimit, err := client.SpendLimits.Update(
		context.TODO(),
		"product",
		telnyx.SpendLimitUpdateParams{
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", spendLimit.Data)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.spendLimits.SpendLimitUpdateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        SpendLimitUpdateParams params = SpendLimitUpdateParams.builder()
            .build();
        var response = client.spendLimits().update("product", params);
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $spend_limit = $client->spendLimits->update(
    'product',
  );

  var_dump($spend_limit);
} catch (APIException $e) {
  echo $e->getMessage();
}

curl --request PATCH \
  --url https://api.telnyx.com/v2/spend_limits/{product} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 250
}'

{
  "data": {
    "record_type": "spend_limit",
    "product": "inference",
    "product_name": "Inference",
    "period": "daily",
    "period_start": "2026-09-24",
    "period_end": "2026-09-25",
    "limit": {
      "amount": "250",
      "unlimited": false,
      "origin": "self_service",
      "updated_at": "2026-09-24T09:12:03.412Z"
    },
    "effective_limit_usd": "250",
    "spend_usd": "37.41",
    "spend_error": null,
    "blocked": false,
    "block": null,
    "evaluation": {
      "spend_usd": "112.50",
      "released": true,
      "blocked_now": false,
      "still_over_limit": false,
      "still_blocked_other_period": false,
      "evaluation_deferred": false
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

product

string

required

Product the limit applies to, as returned in product by the list operation.

Example:

"inference"

Query Parameters

period

enum<string>

default:daily

Limit period. Defaults to daily; send it explicitly. daily is the current UTC day; monthly is the current UTC calendar month.

Available options:

daily,

monthly

Example:

"daily"

credential_id

string

Identifier of one API key as recorded on usage, never the key's secret, percent-encoded: the request is then about that key's limit. Absent means the total limit; present but blank is refused.

Required string length: 1 - 255

Example:

"KEY0192F3A1B2C3D4E5F6A7B8C9D0E1F2"

Body

application/json

Amount
Unlimited

Send exactly one of amount and unlimited: true.

amount

number

required

Limit in USD. 0 blocks at the first cent of spend.

Required range: x >= 0

Example:

100

unlimited

enum<boolean>

Optional; only false is allowed together with amount.

Available options:

false

Example:

false

reason

string

Why the limit is set or changed, kept for audit.

Maximum string length: 500

Example:

"Raised for the product launch"

Response

The limit was updated. evaluation says whether the change lifted or started a block.

data

object

required

The spend limit, spend and block state of one product and period. The top-level fields describe the total limit of the account; API key limits are nested in credential_limits.

Show child attributes

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const SpendLimit = await client.spendLimits.update('product');

console.log(SpendLimit.data);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
spend_limit = client.spend_limits.update(
    product="product",
)
print(spend_limit.data)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	spendLimit, err := client.SpendLimits.Update(
		context.TODO(),
		"product",
		telnyx.SpendLimitUpdateParams{
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", spendLimit.Data)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.spendLimits.SpendLimitUpdateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        SpendLimitUpdateParams params = SpendLimitUpdateParams.builder()
            .build();
        var response = client.spendLimits().update("product", params);
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $spend_limit = $client->spendLimits->update(
    'product',
  );

  var_dump($spend_limit);
} catch (APIException $e) {
  echo $e->getMessage();
}

curl --request PATCH \
  --url https://api.telnyx.com/v2/spend_limits/{product} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 250
}'

{
  "data": {
    "record_type": "spend_limit",
    "product": "inference",
    "product_name": "Inference",
    "period": "daily",
    "period_start": "2026-09-24",
    "period_end": "2026-09-25",
    "limit": {
      "amount": "250",
      "unlimited": false,
      "origin": "self_service",
      "updated_at": "2026-09-24T09:12:03.412Z"
    },
    "effective_limit_usd": "250",
    "spend_usd": "37.41",
    "spend_error": null,
    "blocked": false,
    "block": null,
    "evaluation": {
      "spend_usd": "112.50",
      "released": true,
      "blocked_now": false,
      "still_over_limit": false,
      "still_blocked_other_period": false,
      "evaluation_deferred": false
    }
  }
}

Account & Billing

Video

SETI

Fax

OAuth

Bot Signup

For AI Agents

Update a spend limit

Authorizations

Path Parameters

Query Parameters

Body

Response