Skip to main content
POST
/
datasets
/
pipeline
/
file-upload
Error
A valid request URL is required to generate request examples
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "report.pdf",
  "size": 524288,
  "extension": "pdf",
  "mime_type": "application/pdf",
  "created_by": "ad313dd6-ef04-4dd1-a5b0-c0f0b9e2e7e4",
  "created_at": "2025-03-06T12:00:00"
}

Documentation Index

Fetch the complete documentation index at: https://docs.dify.ai/llms.txt

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

Authorizations

​
Authorization
string
header
required

API Key authentication. For all API requests, include your API Key in the Authorization HTTP Header, prefixed with Bearer. Example: Authorization: Bearer {API_KEY}. Strongly recommend storing your API Key on the server-side, not shared or stored on the client-side, to avoid possible API-Key leakage that can lead to serious consequences.

Body

multipart/form-data
​
file
file
required

The file to upload.

Response

File uploaded successfully.

​
id
string

Unique identifier of the uploaded file.

​
name
string

Original file name.

​
size
integer

File size in bytes.

​
extension
string

File extension.

​
mime_type
string | null

MIME type of the file. May be null if the upload did not include one.

​
created_by
string

ID of the user who uploaded the file.

​
created_at
string | null

Upload timestamp in ISO 8601 format. May be null while the record is being created.