Finish a multipart upload

POST

/media/uploads/{id}/complete

curl --request POST \
  --url https://postflow.biz.id/api/v1/media/uploads/example/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "uploadId": "example", "parts": [ { "partNumber": 1, "etag": "example" } ] }'

Authorizations

• apiKey
• oauth

Parameters

Path Parameters

id

required

string

MediaId from start

Request Body^required

Media typeapplication/json

object

uploadId

required

string

>= 1 characters

parts

required

Array<object>

>= 1 items

object

partNumber

required

integer

>= 1 <= 9007199254740991

etag

required

string

>= 1 characters

Example ^generated

{
  "uploadId": "example",
  "parts": [
    {
      "partNumber": 1,
      "etag": "example"
    }
  ]
}

Responses

200

OK

Media typeapplication/json

object

id

required

Use in mediaIds.

string

kind

required

string

Allowed values: image video

mime

required

string

Allowed values: image/jpeg image/png image/webp image/gif video/mp4 video/quicktime video/webm

sizeBytes

required

integer

width

required

Any of:

integer

integer

null

null

height

required

Any of:

integer

integer

null

null

durationMs

required

Any of:

integer

integer

null

null

originalName

required

string

parentId

required

Any of:

string

Set on edited copies (e.g. a crop) of another file.

string

null

null

url

required

App path of the file. With the API, download it from /media/{id}/file.

string

thumbUrl

required

Any of:

string

string

null

null

createdAt

required

string format: date-time

Example

{
  "kind": "image",
  "mime": "image/jpeg"
}

400

Validation failed. details lists what to fix.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

401

Missing, invalid, expired or deleted key or token.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

403

Not allowed: a read-only key, the owner’s approval, or an owner-only action.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

404

Not found in this workspace.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

More than 120 requests in a minute with this key.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}