Reset budget period

Moves the budget’s period boundary to now; recorded spend is never mutated. Requires gatewayBudgets:update at the organization.

POST /api/gateway/v1/budgets/{id}/reset

Reset budget period

Python

import requests

url = "https://app.langwatch.ai/api/gateway/v1/budgets/{id}/reset"

payload = { "reason": "<string>" }
headers = {
    "X-Auth-Token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

200

{
  "budget": {
    "id": "<string>",
    "organization_id": "<string>",
    "scope_type": "organization",
    "scope_id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "window": "minute",
    "on_breach": "block",
    "limit_usd": "<string>",
    "limit_nano_usd": 0,
    "spent_usd": "<string>",
    "spent_nano_usd": 0,
    "timezone": "<string>",
    "provider_key": "<string>",
    "external_id": "<string>",
    "metadata": {},
    "current_period_started_at": "<string>",
    "resets_at": "<string>",
    "cycle_anchor_at": "<string>",
    "last_reset_at": "<string>",
    "archived_at": "<string>",
    "created_at": "<string>",
    "member_count": 0,
    "end_users_seen": 0,
    "end_users_over": 0,
    "scope_reach": "reachable"
  }
}

Authorizations

X-Auth-Token · string · header · required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Path Parameters

id · string · required

Minimum string length: 1

Query Parameters

end_user_id · string

Minimum string length: 1

Body

application/json

reason · string

Maximum string length: 500

Response

200

application/json

Success

budget · object · required

Show child attributes