Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
PricingDashboard
GuidesAPI ReferenceCLI
API ReferenceBilling and usageBilling

Request a higher approved monthly spend limit

Asks an operator to raise the org's approved monthly spend limit, which caps each deposit and each auto-recharge; the request is reviewed by hand. The requested amount must exceed the $500 default (a request at or below it is a no-op, since the default already covers it) and stay within the $100,000 absolute ceiling; an operator approves or rejects it.

Required permission

Requires the billing.manage permission. See Permissions for the roles and API key permissions that include it.

Command line

The orl CLI wraps this endpoint:

orl billing spend-limit-request create --requested-cents <requested-cents>
POST
/v1/spend-limit-requests

Authorization

apiKey
headerAuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).

Request Body

application/json
  1. body
requestedCents*integer

Must exceed the $500 default and stay within the approvable ceiling.

reason?string
Lengthlength <= 2000

Response Body

Created

application/json
  1. response
id*string
status*"new"
Value in"new"
Example Request
curl -X POST 'https://api.openrelay.inc/v1/spend-limit-requests' \  -H 'Content-Type: application/json' \  -d '{  "requestedCents": 0}'
Example Response
{  "id": "string",  "status": "new"}

List the org's spend-limit requests GET

Lists the org's own requests to raise its approved monthly spend limit, newest first, with each request's amount, reason and review status.

Overview

Current-period usage and cost breakdowns: this month's hours and cost by GPU model and tier, live burn rate and runway, and daily spend over a trailing window.