Facturiadocs

onboarding_link_invalid

This onboarding link is not valid.

This onboarding link is not valid.

Codeonboarding_link_invalid
Typenot_found_error — Does not exist under this credential
HTTP404
Retriable?No

What to do

Unknown and revoked links answer identically on purpose, so nobody can learn who we have asked to sign something. Ask the sender for a new link.

Retrying the same request will fail the same way. Change the request, not the frequency.

The envelope

{
  "error": {
    "type": "not_found_error",
    "code": "onboarding_link_invalid",
    "message": "…",
    "hint": "Unknown and revoked links answer identically on purpose, so nobody can learn who we have asked to sign something. Ask the sender for a new link.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/onboarding_link_invalid",
    "request_id": "req_01K2R7Q9M4T2VB"
  }
}

Program against code, never against message — the prose can be rewritten, the code cannot (§5.8).

hint and retriable arrive in the response with these exact values: they are a function of code and come from the same dictionary GET /v1/error_codes serves, so the envelope and the dictionary cannot disagree. Both are English on the wire by design — one registry, one language. More in The error envelope.

See also

The machine-readable copy of this page lives at GET /v1/error_codes, unauthenticated.

On this page