Get a temporary download link

GET

/api/nova/files/{fileId}/link

Returns a short-lived direct download URL for the document identified by the fileId path parameter, instead of streaming the file through the API. The link points straight at secure storage, expires 15 minutes after it is issued, and needs no API key of its own — so it can be handed to a browser or an end user. Use this when you want to give someone the file; use /download when you need the bytes themselves. Returns 404 when the file does not exist in the account or its contents are still pending upload, 401 for an invalid API key and 429 when rate limited.

Authorizations

privateApiKey

Type

API Key (query: apiKey)

Parameters

Path Parameters

fileId*

fileId

Type

string

Required

Query Parameters

apiKey*

apiKey

Type

string

Required

Responses

OK

Content-Type

application/json

{

  

"data": {

  

  

"contentType": "string",

  

  

"expiresOn": "string",

  

  

"id": "string",

  

  

"name": "string",

  

  

"size": 0,

  

  

"url": "string"

  

},

  

"error": "string",

  

"message": "string",

  

"requestId": "string",

  

"success": true

}

GET

/api/nova/files/{fileId}/link

Playground

Authorization

privateApiKey

Variables

Key

Value

fileId*

apiKey*

Samples