Skip to main content
PATCH
Update account settings

Overview

Changes any of your billing settings, so an agent can manage them without the dashboard. Fields you leave out keep their values, and a request with any invalid field changes nothing.
extraUsage decides whether usage past your credits bills to your card. On Ultra it covers the models outside the plan: turned off, requests to them return 402 once your credits run out, while Ultra’s own models keep working. Turning it back on resumes them at once. monthlySpendLimit caps what extra usage bills to your card each month (null removes it), spendAlert emails you when monthly spend reaches an amount, and autoReload, autoReloadThreshold and autoReloadAmount top up credits from your card. Amounts are USD. From the CLI: morph settings set extra-usage off, morph settings set spend-limit 50, and so on.

Authorizations

Authorization
string
header
required

Morph API key, passed as Authorization: Bearer sk-.... Create keys at https://www.morphllm.com/dashboard/api-keys.

Body

application/json

The settings to change.

The settings to change; the rest keep their values.

extraUsage
boolean

Turn extra usage on or off. A prepaid pay-as-you-go account can turn it off but not on; email support for that.

Example:

false

monthlySpendLimit

Monthly spend limit, at least 1. Null removes it. USD, at most two decimals.

Example:

"50.00"

spendAlert

Spend alert, from 1 to 1000000. Null turns it off. USD, at most two decimals.

Example:

"100.00"

autoReload
boolean

Turn auto-reload on or off.

Example:

true

autoReloadThreshold

Auto-reload threshold, at least 5 and below the amount. USD, at most two decimals.

Example:

"5.00"

autoReloadAmount

Auto-reload amount, at least 10. USD, at most two decimals.

Example:

"40.00"

Response

The account’s settings after the change.

The account’s billing settings.

account
enum<string>
required

Whose settings these are: the key owner’s personal account, or the key’s organization.

Available options:
personal,
organization
Example:

"personal"

plan
string
required

The account’s plan tier, e.g. UNLIMITED (Ultra), SCALE, USAGE (pay as you go), FREE.

Example:

"UNLIMITED"

extraUsage
boolean
required

Whether usage past the account’s credits bills to its card. On Ultra this covers models outside the plan: off, they return 402 once credits run out while Ultra’s models keep serving.

Example:

false

monthlySpendLimit
string | null
required

Monthly cap in USD on what extra usage bills to the card. Null when there is no limit.

Example:

"50.00"

spendAlert
string | null
required

Monthly spend in USD that triggers an email alert. Null when off.

Example:

"100.00"

autoReload
boolean
required

Whether credits top up automatically from the card on file.

Example:

false

autoReloadThreshold
string
required

Auto-reload buys credits when the balance falls below this, in USD.

Example:

"5.00"

autoReloadAmount
string
required

USD of credits each auto-reload buys.

Example:

"40.00"