Skip to main content
POST
Create Asset Upload

Authorizations

Authorization
string
header
required

Send an account API key in the Authorization: Bearer <key> header.

Headers

OpenPMM-Request-Id
string

Optional request ID. OpenPMM returns this value when it is valid. Otherwise, OpenPMM creates a request ID.

Maximum string length: 128
Idempotency-Key
string
required

A unique key for this operation. Use the same key when you retry the same request. Different input with the same key returns 409.

Required string length: 1 - 200

Path Parameters

workspace_id
string
required

Unique workspace ID.

Example:

"ws_01JABCDEF"

Body

application/json

File data that OpenPMM uses to prepare the upload.

kind
enum<string>
required

Generic asset kind. Use video for a video file. This value does not select a provider placement.

Available options:
card,
video,
poster
file_name
string
required
Required string length: 1 - 500
content_type
string
required
Required string length: 1 - 200
byte_size
integer
required
Required range: x >= 1
parts
object[]
required
Required array length: 1 - 10000 elements

Response

Upload instructions and the reserved asset identifier.

id
string
required

Unique upload ID.

Example:

"upl_01JABCDEF"

object
string
required
Allowed value: "asset_upload"
asset_id
string
required

Unique asset ID.

Example:

"ast_01JABCDEF"

protocol
string
required
Allowed value: "multipart"
part_size
integer
required
Required range: x >= 5242880
parts
object[]
required
Required array length: 1 - 10000 elements
byte_size
integer
required
Required range: x >= 1
expires_at
string<date-time>
required
Example:

"2026-08-09T12:00:00.000Z"