Set or remove the monthly spend limit and alert thresholds

Live outbound messages that would exceed the cap are rejected with 403 spend_limit_reached and not charged.

PATCH/v1/spend-limit

Body Parameters

monthly_limit_usdnumber
null removes the cap Maximum 1000000. Minimum 1. Nullable.
alert_thresholdsarray of integer
At most 5 items.

Details

Thresholds fire spend.threshold_reached once each per month. Scope: billing.

Responses

200SpendLimit
Updated spend limit
400Error
Invalid request
401Error
Missing, malformed, or revoked API key
402Error
Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged
429Error
Rate limit or quota exceeded

Response Fields

objectspend_limit
monthly_limit_usdnumber
Nullable.
alert_thresholdsarray of integer
applies_toarray of outbound_sms
estimated_cost_per_message_usdnumber
current_monthobject
current_month.monthstring
Example: 2026-10.
current_month.spent_usdnumber
current_month.remaining_usdnumber
Nullable.
updated_atstring (date-time)
Nullable.

Errors

Every error has the same JSON shape, and request_id matches the X-Request-Id response header. Errors lists every code and what to do about it.

400
Invalid request
401
Missing, malformed, or revoked API key
402
Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged
429
Rate limit or quota exceeded

const res = await fetch('https://api.jointextkit.com/v1/spend-limit', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.TEXTKIT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "alert_thresholds": [
      50,
      80,
      100
    ]
  }),
});

if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();

Response 200

{
  "object": "spend_limit"
}