Skip to main content
POST
/
v1
/
files
Create File
curl --request POST \
  --url https://api.withflex.com/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form purpose=account_requirement \
  --form file='@example-file'
{
  "file": {
    "file_id": "obj_01EXAMPLE00000000000000000",
    "purpose": "account_requirement",
    "filename": "string",
    "size": 0,
    "type": "string",
    "created_at": "2024-01-01T00:00:00Z",
    "expires_at": "2024-01-01T00:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.withflex.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use a Bearer token to access this API.

Body

multipart/form-data

Multipart file upload

Upload a file for use with the Flex API (e.g. dispute evidence).

​
purpose
enum<string>
required

The purpose of the file (e.g. "dispute_evidence").

Available options:
account_requirement,
additional_verification,
business_icon,
business_logo,
customer_signature,
dispute_evidence,
document_provider_identity_document,
finance_report_run,
financial_account_statement,
identity_document,
identity_document_downloadable,
issuing_regulatory_reporting,
pci_document,
platform_terms_of_service,
selfie,
sigma_scheduled_query,
tax_document_user_upload,
terminal_android_apk,
terminal_reader_splashscreen
Example:

"account_requirement"

​
file
file
required

The file to upload (JPEG, PNG, or PDF, max 5MB).

Response

Success

​
file
object
required
Example:
{
  "file_id": "obj_01EXAMPLE00000000000000000",
  "purpose": "account_requirement",
  "filename": "string",
  "size": 0,
  "type": "string",
  "created_at": "2024-01-01T00:00:00Z",
  "expires_at": "2024-01-01T00:00:00Z"
}