# Upload a file

This endpoint allows a client to upload a binary file. The id returned in the
response represents the file in Hypatos systems. It can be used in other endpoints,
for example to initiate processing of the file to create a document holding captured
data, or to include the file in a case.

Endpoint: POST /files
Version: 2.51.0
Security: OAuth2

## Header parameters:

  - `X-Hy-Filename` (string)
    Optional name of the file to be stored along with the content. If not provided, a filename will be generated.

## Response 201 fields (application/json):

  - `id` (string, required)
    Example: "6040dc9680b782b365ea77d5"

## Response 400 fields (application/json):

  - `detail` (string, required)
    A human readable explanation of the error.

  - `status` (integer, required)
    The HTTP status code.

  - `title` (string, required)
    A short summary of the error


## Response 429 fields