Skip to main content
PUT
Update a commission

Authorizations

Authorization
string
header
required

Tolt API key sent as a bearer token.

Path Parameters

id
string
required
Example:

"comm_X85RLnefjTCNrypH4MA1PdSp"

Body

application/json
amount
integer

What the partner earns for this commission, in minor units of the program currency (cents for USD).

Required range: -9007199254740991 <= x <= 9007199254740991
revenue
integer

The sale amount the commission is based on, in minor units of the program currency.

Required range: -9007199254740991 <= x <= 9007199254740991
status
enum<string>
Available options:
pending,
approved,
rejected
source
string | null

Free-form label for where the commission came from, such as stripe or api.

Maximum string length: 255
charge_id
string | null

Id of the payment in your billing system that the commission is for, such as a Stripe charge id.

Maximum string length: 255
transaction_id
string | null

Id of the transaction the commission is for (txn_...). It must belong to the commission's customer, or to its partner and program, and must not be refunded.

created_at
string<date-time>

When the commission was earned, as a timestamp with a time zone, for example 2026-03-01T12:00:00Z. Reports and filters by creation date place the commission on this date; the upcoming approvals forecast goes by its scheduled approval date, which this does not change.

Response

The updated commission

success
boolean
required
Example:

true

message
string
required
Example:

"Request successful"

data
object
required