Skip to Content

Get Temporary File URL

Returns a short-lived (~1 hour) signed storage URL pointing directly at the file bytes. Same model as AWS S3 / CloudFront pre-signed URLs: the URL itself is the capability, time-limited and resource-scoped, so it can be used from browsers, no-code tools, or any HTTP client without forwarding header auth. Call this endpoint again at any time to mint a fresh URL.

GET
/file/{file_id}/url

Generate a temporary, signed URL to directly access and read an uploaded file. This URL is valid for 1 hour.

Path Parameter

  • file_id (string, required)

Example Request

cURL
curl "https://api.vidnavigator.com/v1/file/file_abc123/url" \
  -H "X-API-Key: YOUR_API_KEY"

Success Response (200 OK)

Returns a temporary, signed URL that can be used to access the file directly. The URL will expire after a short period.

{
  "status": "success",
  "data": {
    "file_id": "file_abc123",
    "file_url": "https://signed.aws.url/file_abc123?exp=1700000000"
  }
}

API reference

Authorization

ApiKeyAuth
headerX-API-Key<token>

API key authentication. Include your VidNavigator API key in the X-API-Key header.

Path Parameters

file_id*string

The ID of the file

Response Body

File URL generated successfully

application/json
  1. response
status?"success"
Value in"success"
data?
Example Request
curl -X GET 'https://api.vidnavigator.com/v1/file/string/url'
Example Response
{  "status": "success",  "data": {    "file_id": "string",    "file_url": "https://storage.example.com/path/to/file?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Signature=..."  }}

On this page