POST /_system/assets/stream
Upload a file to the system with streaming support (max 500MB)
Upload a file to the system with streaming support (max 500MB)
| Key | Type | Example | Description |
|---|---|---|---|
| filename required | string |
"example-string"
|
Original filename (URL encoded)
|
| filesize required | integer |
42
|
File size in bytes (max 500MB)
|
| directory required | string |
"example-string"
|
Target directory for upload
Allowed:
public, system_assets, temp |
| filetype optional | string |
"example-string"
|
MIME type (optional, will be detected from extension)
|
| action optional | string |
"example-string"
|
Blueprint action GUID (optional, creates blueprints subfolder)
|
| path optional | string |
"example-string"
|
Custom subdirectory path (optional, URL encoded)
|
| Key | Type | Example | Description |
|---|---|---|---|
| authorization required | string |
"Bearer access_token"
|
Access token
|
{
"name": "example-string",
"type": "example-string",
"assets_guid": "example-string"
}
{
"error": "FILE_TOO_BIG"
}
| Status | Error Code | Description |
|---|---|---|
400 |
FILE_TOO_BIG |
Upload error (file too big, invalid directory, etc.) |
401 |
INVALID_ACCESS_TOKEN |
Authentication required or invalid token |
| Permission | Description |
|---|---|
Bearer token |
Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
assets_create |
Required scope: assets_create |
Back to System Assets Return to the System Assets category to view other endpoints All API Categories Browse all available API categories