v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBFiles
Create File
Uploads a file to Flex. The request must be a multipart/form-data upload containing a file part and a purpose part. The file must be a JPEG, PNG, or PDF no larger than 5 MB; PNGs using 16-bit depth or Adam7 interlacing are rejected. The uploaded file can then be referenced by ID elsewhere in the API, for example as evidence on a dispute. Requires the files_write scope.
post/v1/files
Response
An envelope wrapping a single file object.
Example response
{
"file": {
"file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"purpose": "account_requirement",
"size": 0,
"created_at": "2026-06-15T14:30:00Z",
"expires_at": "2026-06-15T14:30:00Z"
}
}