Reserve an upload (clip a local file)

Step 1 of clipping a local file. Reserves a job and returns a presigned R2 PUT url. PUT the file bytes to upload_url with the given Content-Type, then call POST /v1/uploads/{job_id}/complete. No quota is charged until the complete step. Requires write scope.

post/uploads

Request

  • Base URL: https://katto.tech/api/v1
  • URL: https://katto.tech/api/v1/uploads
  • Auth: HTTP bearer

Request body

filenamestring required
content_type'video/mp4' | 'video/quicktime' | 'video/webm' | 'video/x-matroska' required
sizeinteger required

File size in bytes. Cap: 3 GB Free, 5 GB Solo and Creator.

Example request

{
  "filename": "podcast.mp4"
}

Response

Upload reserved

job_idstring uuid
upload_urlstring uri

Presigned R2 PUT url (2h expiry).

methodstring
headersobject

Headers to send with the PUT (Content-Type).

expires_ininteger
complete_urlstring uri

Example response

{
  "method": "PUT",
  "expires_in": 7200
}

Changes

No recorded changes to this operation across all 1 revision of this API.