Skip to content
Ads API •References / assets / Start Upload Chunked Asset

Start Upload Chunked Asset

Start a chunked asset upload process and retrieve upload session id. Asset type can be image, audio, or video. Client is expected to use max_chunk_size_mb in the response to dynamically determine how big each file chunk should be.

Request

  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • asset_id
    string [uuid]
    Required

    A unique identifier for the entity.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a

Response

Contains a unique upload session ID to be used in subsequent transfer requests. Also, the maximum file chunk size in megabytes.

  • upload_session_id
    string [uuid]

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • max_chunk_size_mb
    integer [int32]

    Maximum file chunk size in megabytes. Client must use this value to dynamically determine how to split the file.

    Example: 10

Response sample

{  "upload_session_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",  "max_chunk_size_mb": 10}