---
title: "How a File Becomes a Submission"
slug: "how-a-file-becomes-a-submission"
updated: 2025-07-18T05:18:53Z
published: 2025-07-18T05:18:53Z
canonical: "help.hyperscience.ai/how-a-file-becomes-a-submission"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.hyperscience.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# How a File Becomes a Submission

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](/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](/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](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?](/v41/docs/what-is-a-submission) and [Document Classification](/v41/docs/document-classification).