Store a file from a URL into RenderIO storage for use as an input in FFmpeg commands.

Store File

POST /api/v1/files/store-file

Download a file from a URL and store it in RenderIO storage. The file is fetched and processed asynchronously to extract metadata. Poll the Get File endpoint to check when processing is complete.

Stored files can be referenced by their storage_url in subsequent FFmpeg commands as input files. This is useful when you want to pre-stage files that will be used across multiple commands.

Authentication

Requires API key via X-API-KEY header.

Request

Headers

Header	Type	Required	Description
`Content-Type`	`string`	Yes	Must be `application/json`
`X-API-KEY`	`string`	Yes	Your API key with `ffsk_` prefix

Body

{
  file_url: string;
}

Field	Type	Required	Description
`file_url`	`string`	Yes	A valid, publicly accessible URL to download the file from.

Response

200 OK

{
  file_id: string;
}

Field	Type	Description
`file_id`	`string`	Unique identifier for the stored file. Use this to poll for processing status.

Error responses

Status	Error	Description
`400`	`INVALID_REQUEST`	Missing `file_url` field or the URL is not valid.
`401`	`UNAUTHORIZED`	Missing or invalid API key.
`422`	`VALIDATION_ERROR`	The provided URL is malformed or unreachable.
`429`	`RATE_LIMITED`	Too many requests. Retry after the period indicated in the `Retry-After` header.

Examples

curl

curl -X POST https://renderio.dev/api/v1/files/store-file \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: ffsk_your_api_key_here" \
  -d '{
    "file_url": "https://example.com/sample.mp4"
  }'

JavaScript (fetch)

const response = await fetch(
  "https://renderio.dev/api/v1/files/store-file",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-KEY": "ffsk_your_api_key_here",
    },
    body: JSON.stringify({
      file_url: "https://example.com/sample.mp4",
    }),
  },
);

const { file_id } = await response.json();
console.log("File ID:", file_id);

Python (requests)

import requests

response = requests.post(
    "https://renderio.dev/api/v1/files/store-file",
    headers={
        "Content-Type": "application/json",
        "X-API-KEY": "ffsk_your_api_key_here",
    },
    json={
        "file_url": "https://example.com/sample.mp4",
    },
)

data = response.json()
print("File ID:", data["file_id"])

Store File

On this page