API Reference
Videos
Create video

Uploading Videos

Uploading videos is done by sending a PUT request to the /videos/upload endpoint to create a new video object. You will get a response containing a signed S3URL to upload the video file to.

Create video object

curl -X PUT https://app.ignitevideo.cloud/api/videos/upload \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "Your video title", "slug": "your-video-slug", "extension": "mp4"}'

Response

{
  "videoId": "[VIDEO_ID]",
  "title": "Your video title",
  "slug": "your-video-slug",
  "extension": "mp4",
  "signedUrl": "[SIGNED_URL]",
}

Upload video file

Upload your video file as a PUT request to the signed URL returned in the previous step. You have to pass the mime type of the file as Content-Type header. You can get the mime type from your local video file via the file input element.

curl -X PUT [SIGNED_URL] \
  -H "Content-Type: [MIME_TYPE]" \
  --data-binary "@[PATH_TO_VIDEO_FILE]"

Encoding process

After the video file has been uploaded, the video will be encoded. This process can take a while, depending on the video size and encoding complexity.

You can check the encoding status of a video by calling the /videos/[VIDEO_ID] endpoint as described in the get video section.