> For the complete documentation index, see [llms.txt](https://docs.atomyx.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.atomyx.io/atomyx-submit/troubleshooting/atomyx-submit-troubleshooting/upload-failures.md).

# Upload Failures

Upload failures happen when a customer cannot submit a file successfully, or when the upload completes but the file is rejected before it can move into the submission workflow.

Common causes include:

* file size limits
* unsupported file types
* network timeouts
* authentication problems

### File too large

#### Typical symptoms

* the customer sees a message such as **File exceeds maximum size**
* the error appears before the upload really starts
* larger files fail consistently while smaller ones work

#### What to check

* the portal maximum file size setting
* the actual size of the uploaded file
* whether the browser or infrastructure has its own request size limits

#### How to resolve it

* ask the customer to reduce the file size where appropriate
* raise the configured upload size if the current limit is too restrictive
* consider chunked upload for very large files

### Unsupported file type

#### Typical symptoms

* the customer sees **File type not supported**
* files that are not PDF are rejected immediately
* the file extension may not match the actual file format

#### What to check

* the accepted file types configured in the portal
* the real MIME type of the uploaded file
* whether the workflow expects PDF only or includes conversion from other formats

#### How to resolve it

* restrict the portal clearly to PDF if that is the intended workflow
* if other design formats must be accepted, add a conversion step before preflight
* validate MIME type as well as filename extension

### Network timeout during upload

#### Typical symptoms

* upload starts but stalls or fails after a delay
* customers on slow or unstable networks hit the issue more often
* partial uploads may be abandoned

#### What to check

* portal upload timeout settings
* network conditions and bandwidth
* server logs for interrupted upload connections

#### How to resolve it

* increase upload timeout thresholds where sensible
* use chunked uploads and resumable upload logic if available
* test the same file on a different network
* reduce restart pain for large files by avoiding single long upload requests

### Authentication failure during upload

#### Typical symptoms

* upload fails with authentication or authorization errors
* the issue affects all users, not only one file
* it may appear after API key changes or configuration changes

#### What to check

* API key configuration
* request header format
* whether the portal can still reach the Atomyx services it depends on

#### How to resolve it

* verify the configured API key
* replace expired or revoked keys
* confirm the expected authentication header format
* test the relevant key independently outside the portal flow

### Related pages

* **Portal Setup**
* **API Integration**
* **Authentication and API Keys** in Vault
* **Submit Troubleshooting**


---

# 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:

```
GET https://docs.atomyx.io/atomyx-submit/troubleshooting/atomyx-submit-troubleshooting/upload-failures.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
