Bulk update usage estimates

View as Markdown

Records the expected total output quantity for usage-based performance obligations, across any number of contracts. Estimates are append-only: each call adds a revision rather than overwriting, and a quantity already in effect comes back as UNCHANGED. A revision restates the revenue schedule going forwards, leaving closed periods and the allocated transaction price untouched.

Authentication

Authorizationstring
API Key authentication via header

Request

This endpoint expects an object.
itemslist of objectsRequired
Estimates to record, at most 100 per request. A performance obligation may appear only once.

Response

Accepted. One result per request entry, in request order — UPDATED, UNCHANGED, or REJECTED with a reason. Entries are applied independently, so one rejection does not stop the rest.

payloadobject
Response payload, will be empty when success is false
successboolean

Boolean with true=success, false=failure

messagestring

Plain-text description of the result

errorobjectOptional
json element with any error messages or warnings

Errors

400
Bad Request Error
500
Internal Server Error