# Create a new file V2.1.

To upload a new file, you'll first need to use the File API. It will give you a URL – use that URL to upload your file. Once the upload is finished, you can use the file_id from the same response to start using our AI features.

Endpoint: POST /s2s/v2.1/file/skin-analysis
Security: BearerAuthenticationV2

## Request fields (application/json):

  - `files` (array, required)

  - `files.content_type` (string, required)
    Content MIME type for this file. Currently available values are listed in the enum.
    Example: "image/jpg"

  - `files.file_name` (string, required)
    Name of this file
    Example: "my-selfie.jpg"

  - `files.file_size` (integer, required)
    Content length for this file in bytes. Should not be larger than 10MB.
    Example: 50000

## Response 200 fields (application/json):

  - `status` (integer)
    Response status
    Example: 200

  - `data` (object)

  - `data.files` (array)

  - `data.files.content_type` (string)
    Content MIME type for this file.
    Example: "image/jpg"

  - `data.files.file_name` (string)
    Name of this file
    Example: "my-selfie.jpg"

  - `data.files.file_id` (string)
    ID of this file. Other run task API will need this file_id.
    Example: "U8aqJbsXGT537jtGnEDFHqxdDXqh8+oTF/cSkLimzuvVwMP+Jb1XbjPsf7ZgUgLY"

  - `data.files.requests` (array)
    Using upload url, headers, method below to upload file. After completion, the file_id is used to proceed with calling run task API.

  - `data.files.requests.headers` (object)
    Headers to include when uploading the file
    Example: {"Content-Type":"image/jpg","Content-Length":50000}

  - `data.files.requests.method` (string)
    HTTP method to use for upload
    Example: "PUT"

  - `data.files.requests.url` (string)
    Pre-signed URL for uploading the file
    Example: "https://example.com/upload"

## Response 400 fields (application/json):

  - `status` (integer)
    Response status
    Example: 400

  - `error` (string)
    Example: "Invalid parameter value"

  - `error_code` (string)
    Example: "InvalidParameters"

## Response 401 fields (application/json):

  - `status` (integer)
    Response status
    Example: 401

  - `error` (string)
    Example: "Invalid API key"