> For the complete documentation index, see [llms.txt](https://docs.sedona.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sedona.fun/troubleshooting.md). # Troubleshooting [← Back to dashboard](https://www.sedona.fun/dashboard/api-keys) ## Authentication fails Confirm that `FLEET_API_KEY` contains the show-once developer key and that the process sends it as a bearer credential. Do not include quotes, whitespace, `Bearer` , or a variable name inside the value. The bootstrap administrator credential is an internal recovery mechanism, not a developer key. ## Authorization fails The key may be valid but lack the administrator role or the requested line grant. Ask the Fleet owner to verify the named user and line assignment. A line outside a user's grants appears not found by design. ## The base URL returns 404 Use the production origin exactly: ``` https://fleet-api-production-fleet-api.up.railway.app ``` Do not append `/v0` to `FLEET_BASE_URL`. Staging is intentionally unavailable and is not a fallback. ## A send timed out Treat `outcome_unknown` as possibly dispatched. Preserve the same logical request and idempotency key, inspect message history or events, and reconcile before retrying. Never generate a new key merely because the client did not observe a response. ## A webhook signature fails Verify the exact raw bytes and original header pairs. Do not verify a parsed or re-serialized body. Confirm that the receiver uses the show-once signing secret from the same subscription. An API key is not a webhook signing secret. ## A webhook is delivered more than once Fleet delivery is at least once. Deduplicate durably on `X-Fleet-Event-Id`. Returning 2xx only after the application transaction commits prevents an acknowledged event from being lost. ## CommonJS cannot import the package The release candidate is ESM-only. Use an ESM application or dynamic `import()` from CommonJS. TypeScript should use `node16`, `nodenext`, or `bundler` module resolution. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.sedona.fun/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.