portal-connection-failed

portal-connection-failed

HTTP 409 Conflict
Content-Type: application/problem+json

{
  "type": "https://docs.transmute.403fin.io/errors/portal-connection-failed",
  "title": "...",
  "status": 409,
  "detail": "...",
  "requestId": "req_01J..."
}

The dashboard tried to use an accounting connection that cannot do the requested action: it is still pending, was revoked, is in an error state, or the accounting platform rejected it.

Common causes

• The connection was disconnected on the accounting platform's side
• The consent flow was not completed
• The platform rejected the stored authorisation

How to fix it

Disconnect the connection in the dashboard and connect it again.

Does it bill?

Not applicable — portal routes are never metered. See Test vs Live Keys for the full billing rules.

Related

• Accounting Connections — connecting and posting
• API equivalent: connection-failed
• Errors Overview — the problem+json shape and the closed catalog
• Every response carries an X-Request-Id; quote it when contacting support.