mandate_widen: A child mandate may only narrow
The requested mandate allows something its delegator's does not: a wider category set, a deeper maxDepth, a longer window, a higher limit, a looser payee list, a weaker approval threshold, or a lower minPayeeAssurance or minAgentVerification. On a child open nothing was opened. A mandate amendment of a running stream (POST /owner/v1/streams/{id}/amend) that is wider than the stream's current mandate answers the same code, and nothing changed.
What to do
- Send a child mandate that is a subset of the delegator's, or omit it to inherit the delegator's.
- Amend a running stream only to a mandate inside its current one.
On the wire
HTTP 409, error type mandate_error.
On a stream open or delegation or a human payment, a client that does not send Dynamo-Error-Detail: 1 gets {"error": "mandate", "reason": "mandate_widen", "detail": "…"}: the precise reason, without errorDetail. The child adoption preparation (POST /owner/v1/streams/{id}/children/adopt-prepare) and the amend route (POST /owner/v1/streams/{id}/amend) send errorDetail to every client.
The detailed body:
{
"error": "mandate",
"reason": "mandate_widen",
"detail": "…",
"errorDetail": {
"type": "mandate_error",
"code": "mandate_widen",
"message": "…",
"param": "mandate",
"doc_url": "…/errors/mandate_widen.md",
"fix": "a child mandate may only narrow its delegator's mandate"
}
}
See all error codes.