terms_holdback: The holdback is shorter than the term window
A breach can only be reported once its window closes, so a terms stream holds settlements back at least its longest term window. Nothing is opened.
What to do
- Omit
holdbackSeconds(the default is the longest window plus 900 seconds of reporting time) or raise it.
On the wire
HTTP 409, error type state_error.
On a stream open (POST /owner/v1/budgets/{id}/streams) the body carries errorDetail only when the request sends Dynamo-Error-Detail: 1. With the header:
{
"error": "state",
"reason": "terms_holdback",
"detail": "…",
"errorDetail": {
"type": "state_error",
"code": "terms_holdback",
"message": "…",
"param": "terms",
"doc_url": "…/errors/terms_holdback.md",
"fix": "holdbackSeconds must be at least the longest term window; omit it to take that window"
}
}
See all error codes.