Skip to main content
POST
/
v1
/
uploads
Create Upload URL
curl --request POST \
  --url https://api.example.com/v1/uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "public": false
}
'
{
  "id": "<string>",
  "method": "<string>",
  "signedUrl": "<string>",
  "expireTime": "2023-11-07T05:31:56Z",
  "headers": {}
}

Body

application/json
name
string
required

File name.

public
boolean
default:false
required

Whether the file is public.

Response

The request has succeeded.

id
string
required

Upload id.

method
string
required

HTTP method for uploading file.

signedUrl
string
required

Signed URL. Used to upload file.

expireTime
string<date-time>
required

Expire time of the signed URL.

headers
object
required

HTTP headers for uploading file.