Typescript (SDK)

import { Crevio } from "@crevio/sdk";

const crevio = new Crevio({
  apiKey: process.env["CREVIO_API_KEY"] ?? "",
});

async function run() {
  const result = await crevio.files.create({});

  console.log(result);
}

run();

{
  "object": "<string>",
  "id": "<string>",
  "kind": {},
  "upload_status": {},
  "url": {},
  "created_at": {},
  "updated_at": {},
  "filename": "<string>",
  "content_type": "<string>",
  "size": 123,
  "provider": "<string>",
  "file_url": "<string>",
  "upload_url": "<string>",
  "upload_headers": {}
}

Files

Create file

Create a file. The endpoint discriminates between three intents based on which fields you send:

1. Presigned upload — { "filename": "photo.png" } Returns an upload_url and upload_headers. PUT your bytes to that URL, then call POST /v1/files/{id}/uploaded to transition the file from pending to ready.

2. Server-side URL import — { "url": "https://..." } Crevio downloads the bytes for you. Returns immediately with upload_status: "processing". The status flips to ready (or failed) once the background download completes; poll GET /v1/files/{id} to check.

3. External video embed — { "kind": "external_video", "url": "https://youtube.com/..." } Pins a YouTube, Vimeo, or Wistia URL as an embeddable reference. No bytes are stored; status returns as ready immediately. Non-embed URLs are rejected with 422.

POST

files

Typescript (SDK)

import { Crevio } from "@crevio/sdk";

const crevio = new Crevio({
  apiKey: process.env["CREVIO_API_KEY"] ?? "",
});

async function run() {
  const result = await crevio.files.create({});

  console.log(result);
}

run();

{
  "object": "<string>",
  "id": "<string>",
  "kind": {},
  "upload_status": {},
  "url": {},
  "created_at": {},
  "updated_at": {},
  "filename": "<string>",
  "content_type": "<string>",
  "size": 123,
  "provider": "<string>",
  "file_url": "<string>",
  "upload_url": "<string>",
  "upload_headers": {}
}

Authorizations

Authorization

string

header

required

API key in the format: Bearer {api_token}

Body

application/json

kind

enum<string> | null

Defaults to 'file'. Set to 'external_video' to pin a YouTube, Vimeo, or Wistia URL as an embed.

Available options:

file,

external_video,

null

url

string | null

Required when kind=external_video, or for server-side URL imports of files.

filename

string | null

Required for presigned uploads. Optional for URL imports.

Response

File created

object

string

required

string

required

kind

object

required

upload_status

object

required

url

object

required

created_at

object

required

updated_at

object

required

filename

string

required

content_type

string

required

size

integer

required

provider

string

required

file_url

string

required

upload_url

string | null

upload_headers

object

List files

Get file

Documentation Index

Authorizations

Body

Response