AdnovaDocs
Creative Hub

Get a file download URL

Mint a short-lived pre-signed S3 URL to download the original bytes of a file version — the active version by default, or the one named by versionId. Returns 409 if the version has not finished uploading yet (no mediaKey).

GET
/files/{fileId}/download

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Path Parameters

fileId*string

File id.

Length1 <= length

Query Parameters

versionId?string

File version id. Omit to use the file's active version. A version id that does not belong to the file returns 404.

Length1 <= length

Header Parameters

x-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization context (required on every endpoint).

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/creative-hub/v1/files/01J8ZF9K8M7N6P5R4S3T2V1W0X/download?versionId=01J8ZG0L9N8P7Q6R5S4T3V2W1Y" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P"
{
  "url": "https://s3.amazonaws.com/adnova-media/01H8Y3.../01H8YA...?X-Amz-Signature=...",
  "name": "spring-hero.mp4",
  "versionId": "V123ABC..."
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}