---
title: "Upload and authentication"
description: "Fix missing credentials, wrong project settings, and build upload problems."
canonical_url: "https://docs.linguana.dev/docs/troubleshooting/upload-and-auth"
markdown_url: "https://docs.linguana.dev/docs/troubleshooting/upload-and-auth.md"
x_farming_labs_generated_preamble: true
---

# Upload and authentication
URL: /docs/troubleshooting/upload-and-auth
LLM index: /llms.txt
Description: Fix missing credentials, wrong project settings, and build upload problems.

# Troubleshoot upload and authentication

## Missing configuration

“Manifest upload requires apiUrl and token” means `upload` or `translation` is enabled without both values. Either disable remote behavior for extraction-only builds or provide a server/build-only token.

## 401 or 403

Check token revocation, project ID, environment, API origin, and whether the token belongs to the selected environment. Never test by putting the token into browser code. Create a replacement, update CI, verify **Last used**, then revoke the old value.

## The build upload failed

The build sends the text it found to the Linguana API. Keep the HTTP status and request ID when an upload fails. Retrying the same build is safe.

## The file upload failed

If the API returns a separate upload URL, confirm the build runner can reach it and sends the returned headers unchanged. Do not attach the project token to that storage URL.

## The upload did not finish

Check the API and storage service, then retry the same build. Translation should not begin until the upload is complete.

<ExpectedResult>
A successful authenticated build updates token usage and either stops after upload or starts the translation settings you enabled.
</ExpectedResult>

## Next

If a completed manifest does not translate, continue with [Jobs and provider](/docs/troubleshooting/jobs-and-provider).

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).
