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.

Next

If a completed manifest does not translate, continue with Jobs and provider.