UploadsGet upload

Uploads

Get upload API

Check that a file arrived and read its size, type and a temporary preview address.

GEThttps://serastudio.app/api/v1/uploads/{id}

Usage notes

  • The key needs the read permission.
  • Returns 404 until the PUT has 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

StatusCodeWhen it happensRetry
401api_key_missingNo Bearer key was sent in the Authorization header.No
401api_key_invalidThe key is malformed or unknown.No
401api_key_revokedThe key was deleted in the console.No
401api_key_disabledThe key is disabled in the console.No
401api_key_expiredThe key is past its expiration date.No
403insufficient_scopeThe key lacks the read permission. Keys created in the console have it.No
403workspace_forbiddenThe account that owns the workspace is suspended or scheduled for deletion.No
404not_foundThe id is unknown or nothing was uploaded to it yet.No
503temporarily_unavailableThe request could not be completed just now.Yes
500internal_errorSomething failed on our side. The request_id identifies the request.Yes
503api_unavailableThe API is turned off.No