PATCH
/
account
/
{accountId}
Update an account's tier
curl --request PATCH \
  --url https://api.next.orenda.finance/account/{accountId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tier": "premium"
}
'
const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({tier: 'premium'})
};

fetch('https://api.next.orenda.finance/account/{accountId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
import requests

url = "https://api.next.orenda.finance/account/{accountId}"

payload = { "tier": "premium" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

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

print(response.text)
{
  "success": true,
  "accountId": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809",
  "tier": "premium",
  "updatedAt": "2026-06-29T19:52:27.000Z"
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}

Authorizations

Authorization
string
header
required

The back-office user's access token.

Path Parameters

accountId
string<uuid>
required

The account's ID.

Query Parameters

programId
string
required

The program the customer/account belongs to. Required on every request.

Body

application/json
tier
string
required

New tier for the account.

Example:

"premium"

Response

The account's tier was updated.

Standard mutation envelope. Additional fields may be present depending on the operation.

success
boolean
Example:

true