# Create/Upload a new file to your account.

Upload a file to Ryft via our API. Useful if you need to:
  - upload evidence when challenging disputes
  - upload KYB/KYC documents for sub accounts

Endpoint: POST /files
Version: 1.1.0
Security: secretApiKeyAuth

## Header parameters:

  - `Account` (string)
    The linked accountId (use this when uploading VerificationDocument files for sub accounts)
    Example: "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"

## Request fields (multipart/form-data):

  - `file` (string)
    Local path to the file being uploaded
    Example: "./local/files/evidence.pdg"

  - `category` (string)
    The category for the file
    Enum: "Evidence", "VerificationDocument"

  - `metadata` (array,null)
    Any supplementary/custom metadata you want to attach to the file. You can have a maximum of 5 pieces of metadata.

## Response 200 fields (application/json):

  - `id` (string)
    The ID of the file
    Example: "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"

  - `name` (string)
    Name of the file
    Example: "receipt_2024.png"

  - `type` (string)
    The type of the file
    Enum: "Csv", "Jpg", "Png", "Pdf"

  - `category` (string)
    The category of the file
    Enum: "Report", "Evidence", "VerificationDocument"

  - `metadata` (object,null)
    Any additional key-value data you have attached to the file. These will be sent with any associated file events on your webhooks. You can have a maximum of 5 pieces of metadata.
    Example: {"customerId":"1","registered":"123"}

  - `createdTimestamp` (integer)
    The epoch timestamp (seconds) when the file was created
    Example: 1470989538

  - `lastUpdatedTimestamp` (integer)
    The epoch timestamp (seconds) when the file was last updated
    Example: 1470989538

  - `sizeInBytes` (integer,null)
    The size in bytes of the associated file
    Example: 2048

## Response 400 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"