Upload file | Plextera Public API

Uploads a file to Plextera File Service and returns the file metadata including the assigned fileId. Use the fileId to reference this file in subsequent Document Insights or workflow calls.

Supported types include PDF, common image formats (JPEG, PNG, TIFF, WebP), Office documents (DOCX, XLSX, PPTX), plain text, CSV, HTML, archives, audio, and video. Executable and script files are rejected. Maximum file size: 50 MB.

Uploads a file to Plextera File Service and returns the file metadata including the assigned `fileId`. Use the `fileId` to reference this file in subsequent Document Insights or workflow calls. Supported types include PDF, common image formats (JPEG, PNG, TIFF, WebP), Office documents (DOCX, XLSX, PPTX), plain text, CSV, HTML, archives, audio, and video. Executable and script files are rejected. Maximum file size: **50 MB**.

Authentication

Authorizationstring

Pass your API key in the Authorization header using the prefix api-key:

Authorization: api-key YOUR_API_KEY

Pass your API key in the `Authorization` header using the prefix `api-key`: ``` Authorization: api-key YOUR_API_KEY ```

Request

Multipart file upload. The file part is required.

filefileRequired

File content. Executable and script files are rejected. Maximum size: 50 MB.

Response

File uploaded. Returns file metadata including the id to use in downstream calls.

idstring

File identifier. Pass this as fileId when referencing this file in Document Insights or workflow calls.

namestring

Original file name as submitted at upload time.

mimeTypestring

Detected MIME type of the file.

sizeByteslong

File size in bytes.

createdAtdatetime

ISO 8601 timestamp when the file was uploaded.

1	curl -X POST https://api.dev.plextera.com/api/public/v1/files \
2	-H "Authorization: <apiKey>" \
3	-H "Content-Type: multipart/form-data" \
4	-F file=@string

1	{
2	"id": "file_01JY7M4ZVX5R1P3M3Q0TA1S7ZM",
3	"name": "lab-result.pdf",
4	"mimeType": "application/pdf",
5	"sizeBytes": 245760,
6	"createdAt": "2026-04-07T10:05:00Z"
7	}