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

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.