Org Member Quota Decrease

POST /org-member-quota/decrease

Reduce the payment limit (quota) for an org member. The amount is subtracted from the member's postedQuota and availableQuota.

The request is rejected if the reduction would leave availableQuota negative.

The org member receives a push notification when the reduction is applied.

Request

{
  "orgMemberId": "om-xxxxxx",
  "amount": 200,
  "idempotencyKey": "reduce-2026-05-22-001",
  "comment": "End of shift adjustment"
}

Request Parameters

Parameter	Type	Required	Description
`orgMemberId`	string	Yes	The id of the org member to reduce limit for.
`amount`	number	Yes	Amount to remove from the limit. Must be > 0 and can have at most 2 decimal places.
`idempotencyKey`	string	Yes	Unique key per reduction in your system. Retrying with the same key will not double-apply the reduction.
`comment`	string	No	Note

Response

{
  "status": "success",
  "data": {
    "id": "xxxxxx",
    "orgMemberId": "om-xxxxxx",
    "type": "decrease",
    "amount": 200,
    "postedQuota": 5300,
    "availableQuota": 3800,
    "createdTime": "2026-05-22T09:30:00.000Z"
  }
}

Response Fields

Field	Type	Description
`id`	string	Server-generated id for this reduction.
`orgMemberId`	string	The org member whose limit was reduced.
`type`	string	Always `"decrease"`.
`amount`	number	The amount from the request.
`postedQuota`	number	The member's new `postedQuota` after this reduction.
`availableQuota`	number	The member's new `availableQuota` after this reduction.
`createdTime`	string	When the reduction was applied, ISO 8601 UTC.

Errors

Retrying with an idempotencyKey that was already used. Keys are shared between increase and decrease, so a key used on either endpoint is taken.

{
  "status": "error",
  "errorCode": "failed",
  "message": "A quota request with this idempotencyKey has already been applied.",
  "data": {
    "id": "xxxxxx",
    "orgMemberId": "om-xxxxxx",
    "type": "decrease",
    "amount": 200,
    "postedQuota": 5300,
    "createdTime": "2026-05-22T09:30:00.000Z"
  }
}

data is the quota change already applied with this key.