non_canonical_path: The request path is not in canonical form
Every Dynamo server (the core, the hosted front door and the merchant API) refuses a request whose path is not written in canonical form, before it reads any credential. A path is refused when it:
- percent-encodes a character that never needs encoding (a letter, a digit,
-,.,_or~, as in/%6Fwner/v1/budgets); - percent-encodes a
/, a\or a%(%2F,%5C,%25), or holds a malformed escape (%zz, a trailing%4); - has a
.or..segment, an empty segment (//), or a backslash.
Other escapes inside a segment (%20, %40 in an id) are left to the route, which validates the id as usual.
What to do
- Send the path exactly as the API reference writes it: no encoding of letters, digits or
/, no.or..segments, no doubled slashes. - If a client library or proxy rewrites paths, configure it to send them unchanged.
- Nothing was read or changed; send the request again with the canonical path.
On the wire
HTTP 400 on every version (the refusal comes before version and credential checks), with cache-control: no-store:
{
"error": "request",
"reason": "non_canonical_path",
"detail": "non-canonical request path (percent_encoded); send the path unencoded, without dot or empty segments (fail closed)"
}
See all error codes.