Skip to main content
PATCH
/
api
/
v1
/
realms
/
{realmId}
/
credentials
/
balance
Update point balance for a credential by its identifier (email, wallet, discord ID, etc)
curl --request PATCH \
  --url https://api.drip.re/api/v1/realms/{realmId}/credentials/balance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "realmPointId": "<string>",
  "initiatorId": "<string>"
}
'
{
  "credentialId": "<string>",
  "identifier": "<string>",
  "balance": 123,
  "realmPointId": "<string>",
  "linked": true
}

Authorizations

​
Authorization
string
header
required

API Key

Path Parameters

​
realmId
string
required

Realm ID

Query Parameters

​
type
enum<string>
required

Type of credential identifier

Available options:
twitter-id,
discord-id,
wallet,
email,
custom
​
value
string
required

Credential value (email address, wallet address, discord ID, twitter ID, or custom ID)

​
source
string

Required for custom type. The source/provider name (e.g., 'shopify-customer-id', 'internal-user-id')

Body

application/json
​
amount
integer
required

Amount to add (positive) or deduct (negative)

​
realmPointId
string

Realm point (currency) ID. If not provided, uses the realm's default point.

​
initiatorId
string

ID of the user initiating this update

Response

200 - application/json

Default Response

​
credentialId
string
​
identifier
string
​
balance
integer
​
realmPointId
string
​
linked
boolean