Boson logoBoson
Documentation/Troubleshooting/Authentication errors
1 min read

Authentication errors

If you see 401/403 errors when sending traces:

Check the API key

  • make sure BOSON_API_KEY is set
  • ensure you’re using the correct workspace/project key
  • rotate the key if you suspect it leaked

Check the host

If you set BOSON_HOST, confirm it matches your Boson backend (Boson Cloud vs customer-deployed Boson). The SDK must not be pointed at unrelated hosts.

Check permissions and project selection

If your product has projects/environments, confirm the key is allowed to write to that scope.

Next steps