Media - S3 Direct Upload

Complete upload transaction

Completes an upload transaction. For multipart: provide uploadId, key and parts. For simple: provide the fileUrl of the already-uploaded file. PLANNER resources are automatically moved/converted to metricool-download on completion.

patch/v2/media/s3/upload-transactions

Request

  • Base URL: https://app.metricool.com/api
  • URL: https://app.metricool.com/api/v2/media/s3/upload-transactions
  • Auth: none declared

Request body

Example request

{
  "multipart": {
    "uploadId": "abc123xyz...",
    "key": "temporal/12345/202601/abc123_video.mp4",
    "parts": [
      {
        "partNumber": 1,
        "etag": "\"d41d8cd98f00b204e9800998ecf8427e\""
      }
    ]
  },
  "simple": {
    "fileUrl": "https://metricool-temp.s3.amazonaws.com/temp/uploads/1770724258286/video.mov"
  }
}

Response

Upload completed successfully

metadataobject

Example response

{
  "data": {
    "key": "temporal/12345/202601/abc123_video.mp4",
    "bucket": "metricool-temp",
    "fileUrl": "https://metricool-temp.s3.eu-west-1.amazonaws.com/temporal/12345/202601/abc123_video.mp4",
    "etag": "\"d41d8cd98f00b204e9800998ecf8427e\"",
    "convertedFileUrl": "https://metricool-data.s3.eu-west-1.amazonaws.com/video-converter/converted/abc123_video.mp4"
  }
}

Changes

No recorded changes to this operation across all 5 revisions of this API.