Get a video

The video's status and, once it is done, a download link. The link is valid for a short time: fetch the video again for a new one. Needs the videos:read permission.

GET

https://app.mosio.me/v1/videos/{id}

View as Markdown

Authorization

apiKeyAPI key in headerrequired

Path parameters

idstringrequired
The video id, such as vid_6f1c….

Returns

200

The video.

JSON

idstringrequired
statusqueuedorrenderingordoneorfailedorcanceledrequired
templatestringrequired
The template id, composition for a rendered composition, or studio for a Studio project.
created_atstringrequired
format: date-time
finished_atstring | nullrequired
format: date-time
duration_secondsnumber | nullrequired
Length of the finished video.
output_urlstring | nullrequired
Short-lived link to the MP4 once status is done.
errorobject | nullrequired
Why the render failed, when status is failed. Failed videos spend no credits.
- codeoptionalstring
- messageoptionalstring
}

401

The API key is missing or not valid.

JSON

errorunauthorizedorinvalid_api_keyorinsufficient_scopeorforbiddenorinvalid_inputorunknown_template+9 morerequired
A stable error code.
messagestringrequired
A message for people, in Indonesian.
detailsoptionalunknown
More about the error, such as the fields to fix.

404

No such template or video in this workspace.

JSON

errorunauthorizedorinvalid_api_keyorinsufficient_scopeorforbiddenorinvalid_inputorunknown_template+9 morerequired
A stable error code.
messagestringrequired
A message for people, in Indonesian.
detailsoptionalunknown
More about the error, such as the fields to fix.