Upload File - Genviral

import fetch from "node-fetch";

// Step 1: Get upload URL
const response = await fetch("https://www.genviral.io/api/partner/v1/files", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    contentType: "video/mp4",
    filename: "my-video.mp4",
    duration_sec: 42,
    bytes: 8_000_000,
  }),
});

const { data } = await response.json();
// data.uploadUrl = presigned S3 URL
// data.url = https://cdn.vireel.io/partner-api/workspaces/{workspaceId}/... (or /users/{ownerUserId}/...)

// Step 2: Upload file to presigned URL
const fileBuffer = fs.readFileSync("./my-video.mp4");
await fetch(data.uploadUrl, {
  method: "PUT",
  headers: {
    "Content-Type": "video/mp4",
  },
  body: fileBuffer,
});

// Step 3: Use the CDN URL in your post
await fetch("https://www.genviral.io/api/partner/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    caption: "Check this out!",
    media: {
      type: "video",
      url: data.url, // Use the CDN URL
    },
    accounts: [{ id: "account-id" }],
  }),
});

{
  "ok": true,
  "code": 201,
  "message": "Upload URL generated",
  "data": {
    "uploadUrl": "https://storage.example.com/presigned-url...",
    "url": "https://cdn.vireel.io/partner-api/workspaces/workspace_123/abc123.mp4",
    "contentType": "video/mp4",
    "expiresIn": 600
  }
}

POST

api

partner

files

import fetch from "node-fetch";

// Step 1: Get upload URL
const response = await fetch("https://www.genviral.io/api/partner/v1/files", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    contentType: "video/mp4",
    filename: "my-video.mp4",
    duration_sec: 42,
    bytes: 8_000_000,
  }),
});

const { data } = await response.json();
// data.uploadUrl = presigned S3 URL
// data.url = https://cdn.vireel.io/partner-api/workspaces/{workspaceId}/... (or /users/{ownerUserId}/...)

// Step 2: Upload file to presigned URL
const fileBuffer = fs.readFileSync("./my-video.mp4");
await fetch(data.uploadUrl, {
  method: "PUT",
  headers: {
    "Content-Type": "video/mp4",
  },
  body: fileBuffer,
});

// Step 3: Use the CDN URL in your post
await fetch("https://www.genviral.io/api/partner/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    caption: "Check this out!",
    media: {
      type: "video",
      url: data.url, // Use the CDN URL
    },
    accounts: [{ id: "account-id" }],
  }),
});

{
  "ok": true,
  "code": 201,
  "message": "Upload URL generated",
  "data": {
    "uploadUrl": "https://storage.example.com/presigned-url...",
    "url": "https://cdn.vireel.io/partner-api/workspaces/workspace_123/abc123.mp4",
    "contentType": "video/mp4",
    "expiresIn": 600
  }
}

Upload media files directly to Genviral’s CDN. The returned url can then be used when creating posts via /posts or attaching images to packs via /packs/{packId}/images. The stored path is derived from key scope (partner-api/workspaces/{workspaceId} or partner-api/users/{ownerUserId}).

How It Works

Call this endpoint with the file’s content type
Receive a presigned uploadUrl and the final url (CDN URL)
Upload your file directly to the uploadUrl using a PUT request
Use the url in post creation requests or pack-image attachment requests

Body Parameters

contentType

string

required

MIME type of the file. Supported types:

Images: image/jpeg, image/png, image/gif, image/webp, image/heic, image/heif
Videos: video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-m4v

filename

string

Original filename for reference (optional). Used for display purposes only.

duration_sec

number

Optional video duration in seconds. Also accepts duration_seconds, duration, durationSec, or video_duration_sec. Stored with the CDN file record so /posts can hydrate validation metadata when you use the returned url.

bytes

number

Optional file size in bytes. Also accepts size.

Response

Successful requests return 201 with:

uploadUrl - Presigned URL to upload your file (expires in 10 minutes)
url - CDN URL where your file will be accessible after upload
contentType - The content type you specified
expiresIn - Seconds until the upload URL expires (600)

Using With Packs

If your goal is to add a local file to a pack:

Call this endpoint and capture data.uploadUrl + data.url.
Upload your bytes to data.uploadUrl with PUT.
Call Add Pack Image with image_url = data.url.

Examples

Upload a video

import fetch from "node-fetch";

// Step 1: Get upload URL
const response = await fetch("https://www.genviral.io/api/partner/v1/files", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    contentType: "video/mp4",
    filename: "my-video.mp4",
    duration_sec: 42,
    bytes: 8_000_000,
  }),
});

const { data } = await response.json();
// data.uploadUrl = presigned S3 URL
// data.url = https://cdn.vireel.io/partner-api/workspaces/{workspaceId}/... (or /users/{ownerUserId}/...)

// Step 2: Upload file to presigned URL
const fileBuffer = fs.readFileSync("./my-video.mp4");
await fetch(data.uploadUrl, {
  method: "PUT",
  headers: {
    "Content-Type": "video/mp4",
  },
  body: fileBuffer,
});

// Step 3: Use the CDN URL in your post
await fetch("https://www.genviral.io/api/partner/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    caption: "Check this out!",
    media: {
      type: "video",
      url: data.url, // Use the CDN URL
    },
    accounts: [{ id: "account-id" }],
  }),
});

# Step 1: Get upload URL
curl --request POST \
  --url https://www.genviral.io/api/partner/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "contentType": "video/mp4",
    "filename": "my-video.mp4",
    "duration_sec": 42,
    "bytes": 8000000
  }'

# Step 2: Upload to presigned URL (use uploadUrl from response)
curl --request PUT \
  --url "<uploadUrl from step 1>" \
  --header 'Content-Type: video/mp4' \
  --data-binary @my-video.mp4

# Step 3: Use url in your post request

{
  "ok": true,
  "code": 201,
  "message": "Upload URL generated",
  "data": {
    "uploadUrl": "https://storage.example.com/presigned-url...",
    "url": "https://cdn.vireel.io/partner-api/workspaces/workspace_123/abc123.mp4",
    "contentType": "video/mp4",
    "expiresIn": 600
  }
}

Error Responses

400 invalid_json - Request body is not valid JSON
422 invalid_payload - Invalid content type or missing required fields
401 - authentication failed (missing/invalid/revoked token)
402 subscription_required - active Creator/Professional/Business plan required
403 tier_not_allowed - Scheduler tier cannot use Partner API
500 create_failed - Failed to initialize upload (retry)

The presigned upload URL expires after 10 minutes. If it expires before you upload, simply request a new one.

POST /files reserves the CDN URL and upload slot. The file is ready for use only after your PUT to uploadUrl succeeds (HTTP 200/204). If needed, verify reachability with a HEAD/GET against data.url before creating a post.

Retry Post List Files

​How It Works

​Body Parameters

​Response

​Using With Packs

​Examples

​Upload a video

​Error Responses

How It Works

Body Parameters

Response

Using With Packs

Examples

Upload a video

Error Responses