Skip to main content
PATCH
Change your usage summary email
It goes to the email you sign in with: a daily one shortly after each UTC day ends, a weekly one on UTC Mondays for the Monday to Sunday before. It has the calls and top integrations; an Owner’s or Admin’s also has the billing period’s estimated overage, and a Member’s never has dollars. A new choice starts with the next day or week.
  • An Owner or Admin may also set dollar_alerts to turn their own usage alert emails in dollars on or off. An overage or % of overage budget alert emails an Owner or Admin it names, or reaches by role, only while they have it on. It is off until you turn it on, and only you can turn yours on. A Member, or an API key without team:manage, is refused it.
  • Each change is recorded in your team’s audit log. A field you leave out stays as it is.
  • An API key needs jobs:read.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: any signed-in member, for their own records; an API key also needs jobs:read.
  • Effect: Creates or changes something.
  • Errors: business_account_required, role_permission_missing, key_permission_missing, and the errors any request can get.

Authorizations

Authorization
string
header
required

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

Body

application/json
frequency
enum<string>
Available options:
off,
daily,
weekly
dollar_alerts
boolean

Owners and Admins only: turn your own dollar alert emails on or off

Response

Your usage summary

frequency
enum<string>
required

Your own summary email

Available options:
off,
daily,
weekly
members
object[]

Owners and Admins only: every member who gets a summary, and how often. Absent for anyone else

dollar_alerts
boolean

Owners and Admins only: whether you get usage alert emails in dollars (overage and % of overage budget alerts). Off until you turn it on. Absent for anyone else