Troubleshooting a custom server endpoint

Separate browser errors from server failures and collect the details needed to reproduce a failing app action.

A generic error on the page does not tell you where the failure happened. It may come from the browser, your server endpoint, an outside service or the database.

Collect one reproducible example

Note the app URL, the action you tried, the time with timezone, whether you were signed in, and whether it happened in Preview or the published app. Use test data and remove passwords, tokens and personal information before sharing request or response details.

Ask the builder to inspect the request for that action without making changes first. The useful evidence is the endpoint path, HTTP status and response body, along with which version of the app you tested. A browser console error may just report that a server request failed.

Browser logs are not server logs

The builder's preview-console reader reads messages from the preview iframe. It is not a searchable archive of every console.error inside custom server code. Do not assume a missing browser log means the endpoint succeeded, or that a particular server-log retention window is available.

If the response lacks enough detail, ask the builder to add a safe error code or request identifier and a clear user-facing error. Do not expose credentials, full private records or an internal stack trace to visitors. Record enough context to match a report to the failed operation.

Verify the fix

Repeat the failing action with test data, then check the saved result. Test an expected error as well, such as a signed-out request or an unavailable outside service. A failed response can occur after part of the work completed; check before retrying an email, charge or write.

If the problem needs support, send the reproducible steps and request identifier through Help. Include the time, request identifier and whether it failed in Preview or live.

Was this helpful?

Thanks for the signal — it helps us improve the docs.

More in Troubleshooting

When things go wrong

The build failed, the preview won't load, the deploy is stuck. Here's the short list of fixes that work most of the time.

Getting help in Overskill

Three ways to reach us — the in-app help panel, a support ticket, or email. Here's when to use each.

My users get a 401 when they log in

The

Still need help?

If this didn't answer your question, our team is one click away.