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 |
|---|---|---|---|
| filenamerequired | string | | Original filename (URL encoded) |
| filesizerequired | integer | | File size in bytes (max 500MB) |
| directoryrequired | string | | Target directory for upload Allowed: "public", "system_assets", "temp" |
| filetypeoptional | string | | MIME type (optional, will be detected from extension) |
| actionoptional | string | | Blueprint action GUID (optional, creates blueprints subfolder) |
| pathoptional | string | | Custom subdirectory path (optional, URL encoded) |
| Key | Type | Example | Description |
|---|---|---|---|
| authorizationrequired | string | | Access token |
{
"assets_guid": "a23575f49d0af385314c1f02280163374297e018a692e5e4ab85eb307ebf6ebc",
"name": "production",
"type": "totp"
}{
"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