# How a File Becomes a Submission

- Updated on Jul 18, 2025  
- Published on Mar 18, 2025  
- 2 minute(s) read

To create a submission, you need to upload a file or a set of files into Hyperscience. There are two ways to upload files into Hyperscience:

- Through the Hyperscience application  
- Through the Hyperscience API

## Upload files through the Hyperscience application

To be able to upload files through the Hyperscience application, you need to have **Submission Upload** enabled in the **System Settings** section:

1. Go to **Administration > System Settings**.
2. In the General section, click **Edit** next to the **Submission Upload** card.
3. Set the **Submission upload** setting to **Enabled**.
4. Click **Save**.

You can upload files by following the steps below:

1. Go to **Submissions**.
2. Click **Create Submission**.
3. Upload a file or a set of files. You have two ways to upload your files:
   - If you are submitting multiple files, you need to select one of the following two options:
     1. Select **One Submission** **per file** if you’d like each file to become its own submission.
     2. Select **Single Submission** if you’d like to create a single submission from all the files.
     3. Drag and drop your files into the box.
     4. Click **Choose Files** and select your files.
4. Click **Next**.
5. Select a flow from the **Submit to flow** drop-down menu. Optionally, you can also:
   - Select a layout (for Semi-structured documents only).
   - **Add to case** - to learn more about this setting, see [Case Collation](https://help.hyperscience.ai/v41/docs/case-collation).
   - Enable **Machine extract only** - if you enable this setting, the system will not create any Supervision, Consensus, or QA tasks for the submission.
   - Click **Upload**.

Once the files are uploaded, a submission is created. You can find the submission on the Submissions page. To learn more about the Submissions page, see [Navigating the Submissions Page](https://help.hyperscience.ai/v41/docs/navigating-the-submissions-page).

## Upload files through the Hyperscience API

You can upload a file or a set of files through the API. Upon successful upload, these files will form a submission and you will be able to find them on the Submissions page.

To upload files through the API, you need to authenticate your user and make a POST request to _/api/v5/submissions_. The only required parameter of the request is:

- _file_ for _multipart/form-data_ and _application/x-www-form-urlencode_ encoding. This parameter accepts either a file as _multipart/form-data_ or a string that defines a path of a file to be retrieved and included in the submission.

- _files_ for _application/json_ encoding. For each file, this parameter can have one of the following:
  - JSON object with keys: _file_content_base64_, which accepts Base64-encoded file data as either a plain text string or a data URI scheme string, and _filename_, which contains the name of the file.
  - JSON object with key: _file_url_, which accepts the URL of the file's location. The supported file types are JPEG, PNG, TIFF, PDF, and XPS.

You can also add additional parameters. To learn more, see the [Submission Creation API documentation (opens in new tab)](https://docs.hyperscience.ai/#submission-creation).

## What happens next?

Once a file has become a submission, the system then interprets each submission’s image as a page and matches each page to a live layout in the system. Pages are grouped into a document based on the matched layout. If the machine fails to classify the pages automatically, you need to perform Document Classification Supervision. To learn more, see [What is a Submission?](https://help.hyperscience.ai/v41/docs/what-is-a-submission) and [Document Classification](https://help.hyperscience.ai/v41/docs/document-classification).