pack-revenue.balancesModule 28See what each pack author has earned and is still owed, with every minor unit accounted for, before anyone is paid.
pack-revenue.balances reads the earnings ledger behind the pack registry. Revenue lines are split once into a platform share and an author share, held through a refund window, and closed into statements. balances shows what each author key carries forward and their payee state.
Put admission in front of your MCP servers, repositories, SaaS tools and cloud accounts. Every agent gets a lease or a reason – and you keep the lever to stop any of them.
© 2026 Intramedial. All rights reserved. Intramedial is a product by Trustvice. Secured and supercharged by Avonao Labs.
Report abuseNo payout provider is bound, so close writes statements and records each payout as paid: false with a reason. Settle authors outside the plane from payableMinor; treat balances as a record, not a transfer.
Plane module
balancesauthorKeyIdunattributed when the registry did not recognize the key on the line.carriedForwardMinor0 for an author with no statement yet./docs/pack-revenue-balancesAPI referenceRoutes, bodies and status codes./docs/pack-revenue-balancesOpen the consoleSee the module at work in the dashboard, on a seeded fleet or your own./app/pack-revenueStart freeCreate a workspace and admit your first intent./auth/signup
payeenone, onboarding, payable or restricted.currencyusd.withheldbelow-minimum, no-payee, payee-not-payable, negative-balance or unattributed.payableMinorterms reads or sets platformFeeBps, minimumPayoutMinor and holdDays. The defaults are 500, 5000 and 30, in usd.
record adds a line with packId, grossMinor and a kind of install, usage or adjustment. It splits once and rounds in the author's favor.
payee sets an author key to none, onboarding, payable or restricted. payable needs an account reference and restricted needs a reason.
close takes from and to, writes a statement per author and records each payout attempt. A paid statement is never paid twice.
This module's calls change real state or reach outside services, so the shared demo does not run them. Sign in to run it in your own workspace. pack-revenue.balances docs
This module's calls change real state or reach outside services, so the shared demo does not run them. Sign in to run it in your own workspace.
A request in the shape the API accepts, and an example response in the shape the module returns.
GET /api/v1/acp/pack-revenue/balances Authorization: Bearer av_workspace_•••• → 200 { balances, currency }
{
"balances": [
{
"authorKeyId": "key_9f2a41",
"carriedForwardMinor": 1840,
"payee": "onboarding"
},
{
"authorKeyId": "unattributed",
"carriedForwardMinor": 950,
"payee": "none"
}
],
"currency": "usd"
}Read balances after a close to see who is carrying money and why. A balance under the minimum simply carries to the next period.
Each statement satisfies broughtForwardMinor + earnedMinor - payableMinor = carriedForwardMinor, so a disputed figure traces to lines.
A line whose key the registry does not recognize lands under unattributed with a note, not in the platform's share.
refund reverses a line using the split that was applied. It is idempotent: a second refund returns the first with alreadyReversed.
metering.snapshot for usage.packs.list.A module is a strong claim about a narrow thing. Rely on it for exactly what it is.
close for a period is idempotent: statements are keyed by author and period, and a statement already paid is skipped.paid: false, and the statement stands.unattributed balance ever reaches an author. Nothing in the code reassigns it when a key is later trusted, so it needs a manual step.carriedForwardMinor comes from the last statement, not from open lines.Every amount is an integer in minor units. A negative gross is refused by record; a refund is its own route.
Earnings stay in heldMinor for holdDays after the line; a statement's payableMinor counts only what has cleared at the close time.
An author with a carried balance and no lines in a period still gets a statement, so a balance that stops being reported is not forgotten.
Reading balances, lines, statements and payouts needs no role. Writing terms or payees, and record, refund and close, are for workspace administrators.
install, usage, refund and adjustment. record accepts all but refund, which only the refund route creates.
platformFeeBps is an integer from 0 to 10000. minimumPayoutMinor and holdDays must be non-negative integers.close needs from and to, and from must be before to. A missing period returns 400.payable without an account returns 400, as does restricted without a .Authenticate with a workspace API key as a Bearer token. The base URL is https://api.intramedial.com.
/api/v1/acp/pack-revenue/balancesRead each author's carried balance and payee state./api/v1/acp/pack-revenue/linesList revenue lines, filtered by packId or authorKeyId./api/v1/acp/pack-revenue/recordAdd a revenue line and split it./api/v1/acp/pack-revenue/refundReverse a line exactly, once./api/v1/acp/pack-revenue/payeeRead or set an author's payout state./api/v1/acp/pack-revenue/termsRead or set the fee, minimum and hold window./api/v1/acp/pack-revenue/closeClose a period into statements and record payout attempts./api/v1/acp/pack-revenue/statementsList statements, optionally for one author./api/v1/acp/pack-revenue/payoutsList every payout attempt and its reason.This module has no MCP action. Call it over REST from any agent or program.
packs.list25Signed pack registryBring in a pack of agents, grants and drills from outside, and know who signed it and whether a byte changed on the way.metering.snapshot21Metered usage by workspaceSee what the plane has counted for your workspace, meter by meter, and which billing meter each count feeds.mandates.compile03Mandate studio and replayWrite an agent's charter as code, see what it would change about who may do what, and apply it as the mandate's next version.civics.settings23Workspace constitutionSet how fast the humans must answer your agents' questions, and who is on call, for each urgency in this workspace.change-trains.list24Staged change trainsRoll a change out to part of the fleet first, check it against measured signals, and move it forward one stage at a time.reasonstored.lenses.run26