Skip to content

Return the non-secret browser upload capabilities for this workspace.

GET
/api/workspace/files/uploads/capabilities
curl --request GET \
--url https://example.com/api/workspace/files/uploads/capabilities \
--header 'Authorization: Bearer <token>'
access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

OK

Media typeapplication/json
object
Data
required
Any of:

Effective non-secret upload policy derived from trusted workspace configuration.

object
StorageType
required
integer format: int32
Allowed values: 0 1 2 3 4 5
ManagedMultipartEnabled
required

Whether managed multipart transfer is available.

boolean
LegacyStreamEnabled
required

Whether the legacy stream path is available.

boolean
MaximumFileSizeBytes
required

Effective maximum file size.

integer format: int64
PartSizeBytes
required

Required bounded part size.

integer format: int32
MaximumParallelParts
required

Maximum supported parallel part count.

integer format: int32
ClientChecksumAlgorithm
required

Supported client checksum algorithm.

string
ClientChecksumRequired
required

Whether the client must declare a checksum.

boolean
AllowedMimeTypes
required

Deprecated MIME-only compatibility projection. Use Moltaro.API.Common.Controllers.Workspace.FileSystem.ManagedFileUploadCapabilitiesModel.FileTypeRules.

Array<string>
FileTypeRules
required

Authoritative extension-aware upload rules.

Array<object>

One extension-aware managed upload rule.

object
Extensions
required

Normalized lower-case extensions, including the leading dot.

Array<string>
MimeTypes
required

Normalized lower-case MIME types without parameters.

Array<string>
FileTypePolicyVersion
required

Version of the authoritative extension-aware upload policy.

integer format: int32
FileTypePolicyHash
required

SHA-256 fingerprint of the authoritative extension-aware upload policy.

string
ActiveSessionLimit
required

Maximum simultaneously active upload sessions for the current actor.

integer format: int32
ActiveSessionCount
required

Current simultaneously active upload sessions for the current actor.

integer format: int32
ActiveReservedBytesLimit
required

Maximum active reserved bytes for the current actor.

integer format: int64
ActiveReservedBytes
required

Current active reserved bytes for the current actor.

integer format: int64
RetryAfterSeconds

Retry delay when the actor currently has no upload capacity.

integer format: int32
nullable
InactivityTimeoutSeconds
required

Sliding inactivity lease in seconds.

integer format: int32
AbsoluteSessionLifetimeSeconds
required

Absolute active-session lifetime in seconds.

integer format: int32
Errors
required
Array<object>
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
required
Array<object>
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
required
boolean
Example
{
"Data": null,
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Too Many Requests

Media typeapplication/json
object
Data
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Service Unavailable

Media typeapplication/json
object
Data
required
Any of:

Effective non-secret upload policy derived from trusted workspace configuration.

object
StorageType
required
integer format: int32
Allowed values: 0 1 2 3 4 5
ManagedMultipartEnabled
required

Whether managed multipart transfer is available.

boolean
LegacyStreamEnabled
required

Whether the legacy stream path is available.

boolean
MaximumFileSizeBytes
required

Effective maximum file size.

integer format: int64
PartSizeBytes
required

Required bounded part size.

integer format: int32
MaximumParallelParts
required

Maximum supported parallel part count.

integer format: int32
ClientChecksumAlgorithm
required

Supported client checksum algorithm.

string
ClientChecksumRequired
required

Whether the client must declare a checksum.

boolean
AllowedMimeTypes
required

Deprecated MIME-only compatibility projection. Use Moltaro.API.Common.Controllers.Workspace.FileSystem.ManagedFileUploadCapabilitiesModel.FileTypeRules.

Array<string>
FileTypeRules
required

Authoritative extension-aware upload rules.

Array<object>

One extension-aware managed upload rule.

object
Extensions
required

Normalized lower-case extensions, including the leading dot.

Array<string>
MimeTypes
required

Normalized lower-case MIME types without parameters.

Array<string>
FileTypePolicyVersion
required

Version of the authoritative extension-aware upload policy.

integer format: int32
FileTypePolicyHash
required

SHA-256 fingerprint of the authoritative extension-aware upload policy.

string
ActiveSessionLimit
required

Maximum simultaneously active upload sessions for the current actor.

integer format: int32
ActiveSessionCount
required

Current simultaneously active upload sessions for the current actor.

integer format: int32
ActiveReservedBytesLimit
required

Maximum active reserved bytes for the current actor.

integer format: int64
ActiveReservedBytes
required

Current active reserved bytes for the current actor.

integer format: int64
RetryAfterSeconds

Retry delay when the actor currently has no upload capacity.

integer format: int32
nullable
InactivityTimeoutSeconds
required

Sliding inactivity lease in seconds.

integer format: int32
AbsoluteSessionLifetimeSeconds
required

Absolute active-session lifetime in seconds.

integer format: int32
Errors
required
Array<object>
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
required
Array<object>
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
required
boolean
Example
{
"Data": null,
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}