Get a signed upload for one file

POST

/apps/{appId}/uploads

curl --request POST \
  --url https://api.passion.io/v1/apps/example/uploads \
  --header 'Content-Type: application/json' \
  --data '{ "fileName": "example", "mimeType": "example" }'

Parameters

Path Parameters

appId

required

The id of the App, as Studio shows it.

string

/^[1-9][0-9]*$/

Request Body^required

Media typeapplication/json

object

fileName

required

The name of the file, with its extension, for example “lesson-1.mp4”.

string

>= 1 characters

mimeType

required

The MIME type of the file, for example “video/mp4”, “image/png” or “application/pdf”.

string

/^[a-z]+\/[0-9A-Za-z.+-]+$/

Example^generated

{
  "fileName": "example",
  "mimeType": "example"
}

Responses

200

OK

Media typeapplication/json

object

fileId

required

The id that a lesson block takes, after the upload.

string

upload

required

object

url

required

The address to POST the file to.

string

fields

required

The form fields to send before the file.

object

key

additional properties

Example^generated

{
  "fileId": "example",
  "upload": {
    "url": "example",
    "fields": {
      "additionalProperty": "example"
    }
  }
}