Uploads
Get upload API
Check that a file arrived and read its size, type and a temporary preview address.
GET
https://serastudio.app/api/v1/uploads/{id}Usage notes
- The key needs the read permission.
- Returns
404until thePUThas completed.
Response
{
"id": "vid_3f2c7a9e-5d1b-4c8e-9f20-7a6b5c4d3e21",
"object": "upload",
"kind": "video",
"bytes": 2871304,
"content_type": "video/mp4",
"created_at": "2026-11-09T05:08:21.000Z",
"url": "https://rvzzbovxmjgldcnlbwyx.supabase.co/storage/v1/object/sign/episodes/7d9e2f10-4b3a-4c5d-8e6f-0a1b2c3d4e5f/episodes/refs/3f2c7a9e-5d1b-4c8e-9f20-7a6b5c4d3e21.mp4?token=<signed>",
"url_expires_at": "2026-11-09T06:15:00.000Z"
}Errors
| Status | Code | When it happens | Retry |
|---|---|---|---|
401 | api_key_missing | No Bearer key was sent in the Authorization header. | No |
401 | api_key_invalid | The key is malformed or unknown. | No |
401 | api_key_revoked | The key was deleted in the console. | No |
401 | api_key_disabled | The key is disabled in the console. | No |
401 | api_key_expired | The key is past its expiration date. | No |
403 | insufficient_scope | The key lacks the read permission. Keys created in the console have it. | No |
403 | workspace_forbidden | The account that owns the workspace is suspended or scheduled for deletion. | No |
404 | not_found | The id is unknown or nothing was uploaded to it yet. | No |
503 | temporarily_unavailable | The request could not be completed just now. | Yes |
500 | internal_error | Something failed on our side. The request_id identifies the request. | Yes |
503 | api_unavailable | The API is turned off. | No |