API reference

Version 2026-11-01OpenAPI 3.1Download openapi.json

Upload videos, publish a player, and build around events. Your API key connects your library to your application. Start with the quickstart.

Videos

Create, organise and publish your video library.

List videos

GET /videos

read requests

Return your videos, newest first. Follow next_cursor with the same filters. An insertion between pages can shift a result. Restart from the first page after a cursor expires.

Parameters

query

Name	Type	Required	Description
`status`	enum: waiting_for_upload \| processing \| ready \| failed	No	Filter by status.
`folder_id`	string	No	Filter by folder.
`q`	string	No	Search your video titles.
`limit`	integer	No	Results per page.
`cursor`	string	No	Opaque cursor from the previous response.

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: list	Yes
`data`	array of object (Video)	Yes
`has_more`	boolean	Yes
`next_cursor`	string or null	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

Response 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "video",
      "id": "h87x",
      "title": "Launch trailer",
      "status": "ready",
      "processing": null,
      "failure": null,
      "source": "upload",
      "folder_id": "fld_3",
      "enabled": true,
      "disabled_by_moderation": false,
      "duration": 184,
      "size": 119248005,
      "max_height": 1080,
      "playback": {
        "player_url": "https://todayfiles-play.site/h87x",
        "embed_html": "\u003ciframe src=\"https://todayfiles-play.site/h87x\" width=\"100%\" height=\"100%\" frameborder=\"0\" allowfullscreen\u003e\u003c/iframe\u003e",
        "thumbnail_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/thumb.jpg",
        "poster_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/poster.jpg"
      },
      "created_at": "2026-10-30T23:41:52Z",
      "updated_at": "2026-10-30T23:42:23Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Create a video

POST /videos

write requestsSupports idempotency

Create a video from an upload, an HTTP or HTTPS URL, or a video whose owner allows cloning. For uploads, send bytes to the returned tus endpoint. URL ingest has a separate service ceiling; read the upload guide. Upload creation also spends one upload request.

Parameters

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Request body

application/json · Required

Name	Type	Required
`title`	string	No
`folder_id`	string or null	No
`source`	object	Yes

JSON

{
  "title": "Launch trailer",
  "source": {
    "type": "upload"
  }
}

Responses

Status Description Schema

201 Successful response. object

Name	Type	Required	Description	Example
`video`	object (Video)	Yes		{ "object": "video", "id": "h87x", "title": "Launch trailer", "status": "ready", "processing": null, "failure": null, "source": "upload", "folder_id": "fld_3", "enabled": true, "disabled_by_moderation": false, "duration": 184, "size": 119248005, "max_height": 1080, "playback": { "player_url": "https://todayfiles-play.site/h87x", "embed_html": "<iframe src=\"https://todayfiles-play.site/h87x\" width=\"100%\" height=\"100%\" frameborder=\"0\" allowfullscreen></iframe>", "thumbnail_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/thumb.jpg", "poster_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/poster.jpg" }, "created_at": "2026-10-30T23:41:52Z", "updated_at": "2026-10-30T23:42:23Z" }
`upload`	object or null	Yes		`{ "object": "upload", "id": "up_01jbqz5m3e6k8r9t2v4w6x8y0a", "video_id": "h87x", "status": "waiting", "protocol": "tus", "tus": { "version": "1.0.0", "endpoint": "https://upload.todayfiles.com/files/", "metadata": {}, "chunk_size": { "min": 5242880, "recommended": 16777216, "max": 67108864 } }, "max_bytes": 53687091200, "expires_at": "2026-11-01T10:15:30Z", "created_at": "2026-11-01T08:15:30Z" }`

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

422 A parameter or JSON body needs correction. Error

Request

curl

response=$(curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/videos' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key' \
  --header 'Content-Type: application/json' \
  --data '{"title":"Launch trailer","source":{"type":"upload"}}')
printf '%s\n' "$response"

Node

const response = await fetch("https://api.todayfiles.com/v1/videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"title":"Launch trailer","source":{"type":"upload"}}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/videos",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    json=json.loads("{\"title\":\"Launch trailer\",\"source\":{\"type\":\"upload\"}}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/videos");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"title\":\"Launch trailer\",\"source\":{\"type\":\"upload\"}}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/videos", strings.NewReader("{\"title\":\"Launch trailer\",\"source\":{\"type\":\"upload\"}}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 201

JSON

{
  "video": {
    "object": "video",
    "id": "h87x",
    "title": "Launch trailer",
    "status": "waiting_for_upload",
    "processing": null,
    "failure": null,
    "source": "upload",
    "folder_id": "fld_3",
    "enabled": true,
    "disabled_by_moderation": false,
    "duration": null,
    "size": null,
    "max_height": null,
    "playback": null,
    "created_at": "2026-10-30T23:41:52Z",
    "updated_at": "2026-10-30T23:42:23Z"
  },
  "upload": {
    "object": "upload",
    "id": "up_01jbqz5m3e6k8r9t2v4w6x8y0a",
    "video_id": "h87x",
    "status": "waiting",
    "protocol": "tus",
    "tus": {
      "version": "1.0.0",
      "endpoint": "https://upload.todayfiles.com/files/",
      "metadata": {},
      "chunk_size": {
        "min": 5242880,
        "recommended": 16777216,
        "max": 67108864
      }
    },
    "max_bytes": 53687091200,
    "expires_at": "2026-11-01T10:15:30Z",
    "created_at": "2026-11-01T08:15:30Z"
  }
}

Retrieve a video

GET /videos/{id}

read requests

Retrieve a video. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status	Description	Schema
200	Successful response.	Video
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/videos/h87x' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/videos/h87x", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/videos/h87x",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/videos/h87x");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/videos/h87x", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "video",
  "id": "h87x",
  "title": "Launch trailer",
  "status": "ready",
  "processing": null,
  "failure": null,
  "source": "upload",
  "folder_id": "fld_3",
  "enabled": true,
  "disabled_by_moderation": false,
  "duration": 184,
  "size": 119248005,
  "max_height": 1080,
  "playback": {
    "player_url": "https://todayfiles-play.site/h87x",
    "embed_html": "\u003ciframe src=\"https://todayfiles-play.site/h87x\" width=\"100%\" height=\"100%\" frameborder=\"0\" allowfullscreen\u003e\u003c/iframe\u003e",
    "thumbnail_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/thumb.jpg",
    "poster_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/poster.jpg"
  },
  "created_at": "2026-10-30T23:41:52Z",
  "updated_at": "2026-10-30T23:42:23Z"
}

Update a video

PATCH /videos/{id}

write requests

Update a video. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Request body

application/json · Required

Name	Type	Required
`title`	string	No
`enabled`	boolean	No
`folder_id`	string or null	No

JSON

{
  "title": "Launch trailer",
  "enabled": true
}

Responses

Status	Description	Schema
200	Successful response.	Video
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request PATCH 'https://api.todayfiles.com/v1/videos/h87x' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"title":"Launch trailer","enabled":true}'

Node

const response = await fetch("https://api.todayfiles.com/v1/videos/h87x", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"title":"Launch trailer","enabled":true}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "PATCH", "https://api.todayfiles.com/v1/videos/h87x",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    json=json.loads("{\"title\":\"Launch trailer\",\"enabled\":true}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/videos/h87x");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "PATCH",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"title\":\"Launch trailer\",\"enabled\":true}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("PATCH", "https://api.todayfiles.com/v1/videos/h87x", strings.NewReader("{\"title\":\"Launch trailer\",\"enabled\":true}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "video",
  "id": "h87x",
  "title": "Launch trailer",
  "status": "ready",
  "processing": null,
  "failure": null,
  "source": "upload",
  "folder_id": "fld_3",
  "enabled": true,
  "disabled_by_moderation": false,
  "duration": 184,
  "size": 119248005,
  "max_height": 1080,
  "playback": {
    "player_url": "https://todayfiles-play.site/h87x",
    "embed_html": "\u003ciframe src=\"https://todayfiles-play.site/h87x\" width=\"100%\" height=\"100%\" frameborder=\"0\" allowfullscreen\u003e\u003c/iframe\u003e",
    "thumbnail_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/thumb.jpg",
    "poster_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/poster.jpg"
  },
  "created_at": "2026-10-30T23:41:52Z",
  "updated_at": "2026-10-30T23:42:23Z"
}

Delete a video

DELETE /videos/{id}

write requests

Soft-delete your video. It becomes unavailable through this API immediately.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status	Description	Schema
204	No content.	No content
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request DELETE 'https://api.todayfiles.com/v1/videos/h87x' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/videos/h87x", {
  method: "DELETE",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "DELETE", "https://api.todayfiles.com/v1/videos/h87x",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/videos/h87x");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("DELETE", "https://api.todayfiles.com/v1/videos/h87x", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Uploads

Send bytes directly with resumable tus uploads.

Create an upload target

POST /videos/{id}/upload

upload requestsSupports idempotency

Create a fresh target for a video waiting for bytes. Pass the complete metadata map to your tus client. Use 16 MiB chunks and read max_bytes for this target’s signed ceiling.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Responses

Status	Description	Schema
201	Successful response.	Upload
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error
422	A parameter or JSON body needs correction.	Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/videos/h87x/upload' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key'

Node

const response = await fetch("https://api.todayfiles.com/v1/videos/h87x/upload", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/videos/h87x/upload",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/videos/h87x/upload");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/videos/h87x/upload", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 201

JSON

{
  "object": "upload",
  "id": "up_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "video_id": "h87x",
  "status": "waiting",
  "protocol": "tus",
  "tus": {
    "version": "1.0.0",
    "endpoint": "https://upload.todayfiles.com/files/",
    "metadata": {},
    "chunk_size": {
      "min": 5242880,
      "recommended": 16777216,
      "max": 67108864
    }
  },
  "max_bytes": 53687091200,
  "expires_at": "2026-11-01T10:15:30Z",
  "created_at": "2026-11-01T08:15:30Z"
}

Retrieve the latest upload

GET /videos/{id}/upload

read requests

Return the latest target. The status follows video processing; your tus client tracks transferred bytes.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status	Description	Schema
200	Successful response.	Upload
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/videos/h87x/upload' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/videos/h87x/upload", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/videos/h87x/upload",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/videos/h87x/upload");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/videos/h87x/upload", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "upload",
  "id": "up_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "video_id": "h87x",
  "status": "waiting",
  "protocol": "tus",
  "tus": {
    "version": "1.0.0",
    "endpoint": "https://upload.todayfiles.com/files/",
    "metadata": {},
    "chunk_size": {
      "min": 5242880,
      "recommended": 16777216,
      "max": 67108864
    }
  },
  "max_bytes": 53687091200,
  "expires_at": "2026-11-01T10:15:30Z",
  "created_at": "2026-11-01T08:15:30Z"
}

Folders

Keep related videos together.

List folders

GET /folders

read requests

List folders. Only resources belonging to your account are returned or changed.

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: list	Yes
`data`	array of object (Folder)	Yes
`has_more`	boolean	Yes
`next_cursor`	string or null	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/folders' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/folders", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/folders",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/folders");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/folders", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "folder",
      "id": "fld_3",
      "name": "Trailers",
      "created_at": "2026-11-01T08:15:30Z",
      "updated_at": "2026-11-01T08:15:30Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Create a folder

POST /folders

write requestsSupports idempotency

Create a folder. Only resources belonging to your account are returned or changed.

Parameters

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Request body

application/json · Required

Name	Type	Required	Description	Example
`name`	string	Yes

JSON

{
  "name": "Trailers"
}

Responses

Status	Description	Schema
201	Successful response.	Folder
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error
422	A parameter or JSON body needs correction.	Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/folders' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key' \
  --header 'Content-Type: application/json' \
  --data '{"name":"Trailers"}'

Node

const response = await fetch("https://api.todayfiles.com/v1/folders", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"name":"Trailers"}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/folders",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    json=json.loads("{\"name\":\"Trailers\"}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/folders");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"name\":\"Trailers\"}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/folders", strings.NewReader("{\"name\":\"Trailers\"}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 201

JSON

{
  "object": "folder",
  "id": "fld_3",
  "name": "Trailers",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z"
}

Rename a folder

PATCH /folders/{id}

write requests

Rename a folder. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Request body

application/json · Required

Name	Type	Required	Description	Example
`name`	string	Yes

JSON

{
  "name": "Trailers"
}

Responses

Status	Description	Schema
200	Successful response.	Folder
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request PATCH 'https://api.todayfiles.com/v1/folders/fld_3' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"name":"Trailers"}'

Node

const response = await fetch("https://api.todayfiles.com/v1/folders/fld_3", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"name":"Trailers"}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "PATCH", "https://api.todayfiles.com/v1/folders/fld_3",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    json=json.loads("{\"name\":\"Trailers\"}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/folders/fld_3");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "PATCH",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"name\":\"Trailers\"}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("PATCH", "https://api.todayfiles.com/v1/folders/fld_3", strings.NewReader("{\"name\":\"Trailers\"}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "folder",
  "id": "fld_3",
  "name": "Trailers",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z"
}

Delete a folder

DELETE /folders/{id}

write requests

Delete your folder. Its videos become uncategorised.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status	Description	Schema
204	No content.	No content
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request DELETE 'https://api.todayfiles.com/v1/folders/fld_3' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/folders/fld_3", {
  method: "DELETE",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "DELETE", "https://api.todayfiles.com/v1/folders/fld_3",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/folders/fld_3");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("DELETE", "https://api.todayfiles.com/v1/folders/fld_3", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Add videos to a folder

POST /folders/{id}/videos

write requestsSupports idempotency

Add videos to a folder. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Request body

application/json · Required

Name	Type	Required	Description	Example
`video_ids`	array of string	Yes

JSON

{
  "video_ids": [
    "h87x",
    "q2m8"
  ]
}

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required	Description	Example
`object`	enum: result	Yes
`moved`	integer	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

422 A parameter or JSON body needs correction. Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/folders/fld_3/videos' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key' \
  --header 'Content-Type: application/json' \
  --data '{"video_ids":["h87x","q2m8"]}'

Node

const response = await fetch("https://api.todayfiles.com/v1/folders/fld_3/videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"video_ids":["h87x","q2m8"]}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/folders/fld_3/videos",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    json=json.loads("{\"video_ids\":[\"h87x\",\"q2m8\"]}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/folders/fld_3/videos");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"video_ids\":[\"h87x\",\"q2m8\"]}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/folders/fld_3/videos", strings.NewReader("{\"video_ids\":[\"h87x\",\"q2m8\"]}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "result",
  "moved": 1
}

Remove videos from folders

POST /folders/remove-videos

write requestsSupports idempotency

Remove videos from folders. Only resources belonging to your account are returned or changed.

Parameters

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Request body

application/json · Required

Name	Type	Required	Description	Example
`video_ids`	array of string	Yes

JSON

{
  "video_ids": [
    "h87x"
  ]
}

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required	Description	Example
`object`	enum: result	Yes
`removed`	integer	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

422 A parameter or JSON body needs correction. Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/folders/remove-videos' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key' \
  --header 'Content-Type: application/json' \
  --data '{"video_ids":["h87x"]}'

Node

const response = await fetch("https://api.todayfiles.com/v1/folders/remove-videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"video_ids":["h87x"]}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/folders/remove-videos",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    json=json.loads("{\"video_ids\":[\"h87x\"]}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/folders/remove-videos");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"video_ids\":[\"h87x\"]}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/folders/remove-videos", strings.NewReader("{\"video_ids\":[\"h87x\"]}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "result",
  "removed": 1
}

Clone jobs

Copy videos whose owners allow cloning.

Create a clone job

POST /clone-jobs

write requestsSupports idempotency

Queue up to 200 video ids or player URLs. You can have up to 3 jobs in progress and clone up to 200 videos per rolling hour.

Parameters

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Request body

application/json · Required

Name	Type	Required	Description	Example
`inputs`	array of string	Yes

JSON

{
  "inputs": [
    "h87x",
    "https://todayfiles-play.site/q2m8"
  ]
}

Responses

Status	Description	Schema
202	Successful response.	CloneJob
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error
422	A parameter or JSON body needs correction.	Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/clone-jobs' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key' \
  --header 'Content-Type: application/json' \
  --data '{"inputs":["h87x","https://todayfiles-play.site/q2m8"]}'

Node

const response = await fetch("https://api.todayfiles.com/v1/clone-jobs", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"inputs":["h87x","https://todayfiles-play.site/q2m8"]}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/clone-jobs",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    json=json.loads("{\"inputs\":[\"h87x\",\"https://todayfiles-play.site/q2m8\"]}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/clone-jobs");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"inputs\":[\"h87x\",\"https://todayfiles-play.site/q2m8\"]}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/clone-jobs", strings.NewReader("{\"inputs\":[\"h87x\",\"https://todayfiles-play.site/q2m8\"]}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 202

JSON

{
  "object": "clone_job",
  "id": "cj_1z",
  "status": "completed",
  "counts": {
    "total": 1,
    "succeeded": 1,
    "failed": 0,
    "pending": 0
  },
  "items": [
    {
      "input": "h87x",
      "status": "succeeded",
      "video_id": "q2m8",
      "error": null
    }
  ],
  "created_at": "2026-11-01T08:15:30Z",
  "completed_at": "2026-11-01T08:15:30Z"
}

List clone jobs

GET /clone-jobs

read requests

List clone jobs. Only resources belonging to your account are returned or changed.

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: list	Yes
`data`	array of object (CloneJob)	Yes
`has_more`	boolean	Yes
`next_cursor`	string or null	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/clone-jobs' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/clone-jobs", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/clone-jobs",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/clone-jobs");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/clone-jobs", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "clone_job",
      "id": "cj_1z",
      "status": "completed",
      "counts": {
        "total": 1,
        "succeeded": 1,
        "failed": 0,
        "pending": 0
      },
      "created_at": "2026-11-01T08:15:30Z",
      "completed_at": "2026-11-01T08:15:30Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Retrieve a clone job

GET /clone-jobs/{id}

read requests

Retrieve a clone job. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status	Description	Schema
200	Successful response.	CloneJob
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/clone-jobs/cj_1z' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/clone-jobs/cj_1z", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/clone-jobs/cj_1z",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/clone-jobs/cj_1z");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/clone-jobs/cj_1z", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "clone_job",
  "id": "cj_1z",
  "status": "completed",
  "counts": {
    "total": 1,
    "succeeded": 1,
    "failed": 0,
    "pending": 0
  },
  "items": [
    {
      "input": "h87x",
      "status": "succeeded",
      "video_id": "q2m8",
      "error": null
    }
  ],
  "created_at": "2026-11-01T08:15:30Z",
  "completed_at": "2026-11-01T08:15:30Z"
}

Analytics

Read views, downloads and current viewers.

Query video views

GET /analytics/views

analytics requests

Query your views. Unique counts are exact per daily dimension and can count the same viewer again when summed across days.

Parameters

query

Name	Type	Required	Description
`from`	string (date)	No
`to`	string (date)	No
`group_by`	string	No	Comma-separated date, video, country, device, referrer or player; downloads also accept quality.
`video_id`	string	No
`limit`	integer	No

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: analytics	Yes
`from`	string	Yes
`to`	string	Yes
`group_by`	array of string	Yes
`rows`	array of object	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/analytics/views' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/analytics/views", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/analytics/views",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/analytics/views");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/analytics/views", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "analytics",
  "from": "2026-10-30",
  "to": "2026-11-01",
  "group_by": [
    "date",
    "video"
  ],
  "rows": [
    {
      "date": "2026-10-30",
      "video_id": "h87x",
      "views": 12,
      "completed_views": 12,
      "unique_viewers": 12
    }
  ]
}

Query video downloads

GET /analytics/downloads

analytics requests

Query your downloads. Unique counts can count the same downloader again across daily groups.

Parameters

query

Name	Type	Required	Description
`from`	string (date)	No
`to`	string (date)	No
`group_by`	string	No	Comma-separated date, video, country, device, referrer or player; downloads also accept quality.
`video_id`	string	No
`limit`	integer	No

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: analytics	Yes
`from`	string	Yes
`to`	string	Yes
`group_by`	array of string	Yes
`rows`	array of object	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/analytics/downloads' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/analytics/downloads", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/analytics/downloads",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/analytics/downloads");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/analytics/downloads", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "analytics",
  "from": "2026-10-30",
  "to": "2026-11-01",
  "group_by": [
    "date",
    "video"
  ],
  "rows": [
    {
      "date": "2026-10-30",
      "video_id": "h87x",
      "downloads": 12,
      "unique_downloaders": 12
    }
  ]
}

Retrieve current viewers

GET /analytics/realtime

analytics requests

Retrieve current viewers. Only resources belonging to your account are returned or changed.

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: realtime	Yes
`viewers`	integer	Yes
`window_seconds`	integer	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/analytics/realtime' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/analytics/realtime", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/analytics/realtime",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/analytics/realtime");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/analytics/realtime", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "realtime",
  "viewers": 2,
  "window_seconds": 300
}

Account

Read your account and upload allowance.

Retrieve your account

GET /account

read requests

Retrieve your account. Only resources belonging to your account are returned or changed.

Responses

Status	Description	Schema
200	Successful response.	Account
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/account' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/account", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/account",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/account");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/account", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "account",
  "id": "acct_7",
  "email": "you@example.com",
  "username": "demo",
  "clone_allowed": true,
  "uploads": {
    "max_bytes_per_file": 53687091200,
    "daily_limit": 100,
    "used_today": 3,
    "remaining_today": 97,
    "resets_at": "2026-11-02T00:00:00Z"
  }
}

Webhooks

Receive signed events and inspect delivery attempts.

Create a webhook

POST /webhooks

write requestsSupports idempotency

Use HTTPS on port 443 or 8443. The host must resolve only to public addresses at creation and every delivery. Save the signing secret: it is shown once.

Parameters

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Request body

application/json · Required

Name	Type	Required
`url`	string (uri)	Yes
`events`	array of enum: video.ready \| video.failed \| clone_job.completed	Yes
`description`	string	No

JSON

{
  "url": "https://example.com/hooks/todayfiles",
  "events": [
    "video.ready"
  ],
  "description": "Production"
}

Responses

Status	Description	Schema
201	Successful response.	Webhook
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error
422	A parameter or JSON body needs correction.	Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/webhooks' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key' \
  --header 'Content-Type: application/json' \
  --data '{"url":"https://example.com/hooks/todayfiles","events":["video.ready"],"description":"Production"}'

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"url":"https://example.com/hooks/todayfiles","events":["video.ready"],"description":"Production"}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/webhooks",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    json=json.loads("{\"url\":\"https://example.com/hooks/todayfiles\",\"events\":[\"video.ready\"],\"description\":\"Production\"}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"url\":\"https://example.com/hooks/todayfiles\",\"events\":[\"video.ready\"],\"description\":\"Production\"}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/webhooks", strings.NewReader("{\"url\":\"https://example.com/hooks/todayfiles\",\"events\":[\"video.ready\"],\"description\":\"Production\"}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 201

JSON

{
  "object": "webhook",
  "id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "url": "https://example.com/hooks/todayfiles",
  "events": [
    "video.ready",
    "video.failed"
  ],
  "description": "Production",
  "enabled": true,
  "status": "active",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z",
  "last_delivery": null,
  "secret": "whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

List webhooks

GET /webhooks

read requests

List webhooks. Only resources belonging to your account are returned or changed.

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: list	Yes
`data`	array of object (Webhook)	Yes
`has_more`	boolean	Yes
`next_cursor`	string or null	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/webhooks' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/webhooks",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/webhooks", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "webhook",
      "id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
      "url": "https://example.com/hooks/todayfiles",
      "events": [
        "video.ready",
        "video.failed"
      ],
      "description": "Production",
      "enabled": true,
      "status": "active",
      "created_at": "2026-11-01T08:15:30Z",
      "updated_at": "2026-11-01T08:15:30Z",
      "last_delivery": null
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Retrieve a webhook

GET /webhooks/{id}

read requests

Retrieve a webhook. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status	Description	Schema
200	Successful response.	Webhook
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "webhook",
  "id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "url": "https://example.com/hooks/todayfiles",
  "events": [
    "video.ready",
    "video.failed"
  ],
  "description": "Production",
  "enabled": true,
  "status": "active",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z",
  "last_delivery": null
}

Update a webhook

PATCH /webhooks/{id}

write requests

Update a webhook. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Request body

application/json · Required

Name	Type	Required
`url`	string (uri)	No
`events`	array of enum: video.ready \| video.failed \| clone_job.completed	No
`description`	string	No
`enabled`	boolean	No

JSON

{
  "enabled": true
}

Responses

Status	Description	Schema
200	Successful response.	Webhook
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request PATCH 'https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"enabled":true}'

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"enabled":true}),
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "PATCH", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    json=json.loads("{\"enabled\":true}"),
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "PATCH",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{\"enabled\":true}",
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    request, err := http.NewRequest("PATCH", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a", strings.NewReader("{\"enabled\":true}"))
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Content-Type", "application/json")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "webhook",
  "id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "url": "https://example.com/hooks/todayfiles",
  "events": [
    "video.ready",
    "video.failed"
  ],
  "description": "Production",
  "enabled": true,
  "status": "active",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z",
  "last_delivery": null
}

Delete a webhook

DELETE /webhooks/{id}

write requests

Delete a webhook. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status	Description	Schema
204	No content.	No content
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error

Request

curl

curl --fail-with-body --request DELETE 'https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a", {
  method: "DELETE",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "DELETE", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("DELETE", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Rotate a signing secret

POST /webhooks/{id}/rotate-secret

write requestsSupports idempotency

Save the new secret before leaving this response. Deliveries include signatures for both secrets for 24 hours.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Responses

Status	Description	Schema
200	Successful response.	Webhook
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error
422	A parameter or JSON body needs correction.	Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/rotate-secret' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key'

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/rotate-secret", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/rotate-secret",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/rotate-secret");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/rotate-secret", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "webhook",
  "id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "url": "https://example.com/hooks/todayfiles",
  "events": [
    "video.ready",
    "video.failed"
  ],
  "description": "Production",
  "enabled": true,
  "status": "active",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z",
  "last_delivery": null,
  "secret": "whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Send a test event

POST /webhooks/{id}/test

write requestsSupports idempotency

Send a ping event immediately. The response records the delivery outcome.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

header

Name	Type	Required	Description
`Idempotency-Key`	string	No	Optional key for safely replaying this request for 24 hours.

Responses

Status	Description	Schema
200	Successful response.	Delivery
400	A parameter or JSON body needs correction.	Error
401	Provide an active API key.	Error
404	Unknown or inaccessible resource.	Error
409	The resource cannot accept this change.	Error
429	Wait before retrying.	Error
422	A parameter or JSON body needs correction.	Error

Request

curl

curl --fail-with-body --request POST 'https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/test' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY" \
  --header 'Idempotency-Key: replace-with-a-unique-request-key'

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/test", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
    "Idempotency-Key": "replace-with-a-unique-request-key",
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "POST", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/test",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
        "Idempotency-Key": "replace-with-a-unique-request-key",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/test");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
        'Idempotency-Key: replace-with-a-unique-request-key',
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/test", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    request.Header.Set("Idempotency-Key", "replace-with-a-unique-request-key")
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "delivery",
  "id": "dlv_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "event_id": "evt_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "webhook_id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "attempt": 1,
  "status": "succeeded",
  "response_status": 200,
  "duration_ms": 120,
  "error": "",
  "next_attempt_at": null,
  "created_at": "2026-11-01T08:15:30Z"
}

List webhook deliveries

GET /webhooks/{id}/deliveries

read requests

List webhook deliveries. Only resources belonging to your account are returned or changed.

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Resource id.

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: list	Yes
`data`	array of object (Delivery)	Yes
`has_more`	boolean	Yes
`next_cursor`	string or null	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/deliveries' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/deliveries", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/deliveries",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/deliveries");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/webhooks/wh_01jbqz5m3e6k8r9t2v4w6x8y0a/deliveries", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "delivery",
      "id": "dlv_01jbqz5m3e6k8r9t2v4w6x8y0a",
      "event_id": "evt_01jbqz5m3e6k8r9t2v4w6x8y0a",
      "webhook_id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
      "attempt": 1,
      "status": "succeeded",
      "response_status": 200,
      "duration_ms": 120,
      "error": "",
      "next_attempt_at": null,
      "created_at": "2026-11-01T08:15:30Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Events

Recover events from the last 30 days.

List events

GET /events

read requests

Events remain available for 30 days, newest first. Pass the last event id as after to continue.

Parameters

query

Name	Type	Required
`type`	enum: video.ready \| video.failed \| clone_job.completed \| ping	No
`after`	string	No
`limit`	integer	No

Responses

Status Description Schema

200 Successful response. object

Name	Type	Required
`object`	enum: list	Yes
`data`	array of object (Event)	Yes
`has_more`	boolean	Yes
`next_cursor`	string or null	Yes

400 A parameter or JSON body needs correction. Error

401 Provide an active API key. Error

404 Unknown or inaccessible resource. Error

409 The resource cannot accept this change. Error

429 Wait before retrying. Error

Request

curl

curl --fail-with-body --request GET 'https://api.todayfiles.com/v1/events' \
  --header "Authorization: Bearer $TODAYFILES_API_KEY"

Node

const response = await fetch("https://api.todayfiles.com/v1/events", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.TODAYFILES_API_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
const result = response.status === 204 ? null : await response.json();
console.log(result);

Python

import json
import os
import requests

response = requests.request(
    "GET", "https://api.todayfiles.com/v1/events",
    headers={
        "Authorization": "Bearer " + os.environ["TODAYFILES_API_KEY"],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json() if response.content else None)

PHP

<?php
$client = curl_init("https://api.todayfiles.com/v1/events");
curl_setopt_array($client, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TODAYFILES_API_KEY'),
    ],
]);
$body = curl_exec($client);
if ($body === false) throw new RuntimeException(curl_error($client));
$status = curl_getinfo($client, CURLINFO_RESPONSE_CODE);
curl_close($client);
if ($status >= 400) throw new RuntimeException($body);
$result = $body === '' ? null : json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

package main

import (
    "encoding/json"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.todayfiles.com/v1/events", nil)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer " + os.Getenv("TODAYFILES_API_KEY"))
    response, err := (&http.Client{Timeout: 30 * time.Second}).Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(io.LimitReader(response.Body, 1 << 20))
    if err != nil { panic(err) }
    if response.StatusCode >= 400 { panic(string(body)) }
    var result any
    if len(body) > 0 {
        if err := json.Unmarshal(body, &result); err != nil { panic(err) }
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { panic(err) }
}

Response 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "evt_01jbqz5m3e6k8r9t2v4w6x8y0a",
      "type": "video.ready",
      "created_at": "2026-11-01T08:15:30Z",
      "data": {
        "video": {
          "object": "video",
          "id": "h87x",
          "title": "Launch trailer",
          "status": "ready",
          "processing": null,
          "failure": null,
          "source": "upload",
          "folder_id": "fld_3",
          "enabled": true,
          "disabled_by_moderation": false,
          "duration": 184,
          "size": 119248005,
          "max_height": 1080,
          "playback": {
            "player_url": "https://todayfiles-play.site/h87x",
            "embed_html": "\u003ciframe src=\"https://todayfiles-play.site/h87x\" width=\"100%\" height=\"100%\" frameborder=\"0\" allowfullscreen\u003e\u003c/iframe\u003e",
            "thumbnail_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/thumb.jpg",
            "poster_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/poster.jpg"
          },
          "created_at": "2026-10-30T23:41:52Z",
          "updated_at": "2026-10-30T23:42:23Z"
        }
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Objects

Video

Name	Type	Required	Description
`object`	enum: video	Yes
`id`	string	Yes	Stable resource id.
`title`	string	Yes	Your video title.
`status`	enum: waiting_for_upload \| processing \| ready \| failed	Yes	Uploads wait for bytes, then process before becoming ready or failed.
`processing`	object or null	Yes
`failure`	object or null	Yes
`source`	enum: upload \| url \| clone \| ftp \| torrent \| import	Yes
`folder_id`	string or null	Yes
`enabled`	boolean	Yes
`disabled_by_moderation`	boolean	Yes
`duration`	integer or null	Yes	Duration in seconds, when known.
`size`	integer or null	Yes	Size in bytes, when known.
`max_height`	integer or null	Yes
`playback`	object or null	Yes
`created_at`	string (date-time)	Yes
`updated_at`	string (date-time)	Yes

JSON

{
  "object": "video",
  "id": "h87x",
  "title": "Launch trailer",
  "status": "ready",
  "processing": null,
  "failure": null,
  "source": "upload",
  "folder_id": "fld_3",
  "enabled": true,
  "disabled_by_moderation": false,
  "duration": 184,
  "size": 119248005,
  "max_height": 1080,
  "playback": {
    "player_url": "https://todayfiles-play.site/h87x",
    "embed_html": "\u003ciframe src=\"https://todayfiles-play.site/h87x\" width=\"100%\" height=\"100%\" frameborder=\"0\" allowfullscreen\u003e\u003c/iframe\u003e",
    "thumbnail_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/thumb.jpg",
    "poster_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/poster.jpg"
  },
  "created_at": "2026-10-30T23:41:52Z",
  "updated_at": "2026-10-30T23:42:23Z"
}

Upload

Name	Type	Required	Description
`object`	enum: upload	Yes
`id`	string	Yes	Stable resource id.
`video_id`	string	Yes
`status`	enum: waiting \| expired \| processing \| completed	Yes
`protocol`	enum: tus	Yes
`tus`	object	Yes
`max_bytes`	integer	Yes	The byte ceiling signed for this upload target. Read this value before uploading.
`expires_at`	string (date-time)	Yes	Creation deadline for this target.
`created_at`	string (date-time)	Yes

JSON

{
  "object": "upload",
  "id": "up_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "video_id": "h87x",
  "status": "waiting",
  "protocol": "tus",
  "tus": {
    "version": "1.0.0",
    "endpoint": "https://upload.todayfiles.com/files/",
    "metadata": {},
    "chunk_size": {
      "min": 5242880,
      "recommended": 16777216,
      "max": 67108864
    }
  },
  "max_bytes": 53687091200,
  "expires_at": "2026-11-01T10:15:30Z",
  "created_at": "2026-11-01T08:15:30Z"
}

Folder

Name	Type	Required	Description
`object`	enum: folder	Yes
`id`	string	Yes	Stable resource id.
`name`	string	Yes
`created_at`	string (date-time)	Yes
`updated_at`	string (date-time)	Yes

JSON

{
  "object": "folder",
  "id": "fld_3",
  "name": "Trailers",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z"
}

CloneJobItem

Name	Type	Required
`input`	string	Yes
`status`	enum: pending \| running \| succeeded \| failed	Yes
`video_id`	string or null	Yes
`error`	object or null	Yes

JSON

{
  "input": "h87x",
  "status": "succeeded",
  "video_id": "q2m8",
  "error": null
}

CloneJob

Name	Type	Required	Description
`object`	enum: clone_job	Yes
`id`	string	Yes	Stable resource id.
`status`	enum: queued \| running \| completed	Yes
`counts`	object	Yes
`items`	array of object (CloneJobItem)	No
`created_at`	string (date-time)	Yes
`completed_at`	string or null	Yes

JSON

{
  "object": "clone_job",
  "id": "cj_1z",
  "status": "completed",
  "counts": {
    "total": 1,
    "succeeded": 1,
    "failed": 0,
    "pending": 0
  },
  "items": [
    {
      "input": "h87x",
      "status": "succeeded",
      "video_id": "q2m8",
      "error": null
    }
  ],
  "created_at": "2026-11-01T08:15:30Z",
  "completed_at": "2026-11-01T08:15:30Z"
}

Webhook

Name	Type	Required	Description
`object`	enum: webhook	Yes
`id`	string	Yes	Stable resource id.
`url`	string (uri)	Yes	HTTPS endpoint on a public address, using port 443 or 8443.
`events`	array of enum: video.ready \| video.failed \| clone_job.completed	Yes
`description`	string	Yes
`enabled`	boolean	Yes
`status`	enum: active \| disabled \| disabled_after_failures	Yes
`secret`	string	No	Shown only after creation or rotation. Save it before leaving this response.
`created_at`	string (date-time)	Yes
`updated_at`	string (date-time)	Yes
`last_delivery`	object or null	Yes

JSON

{
  "object": "webhook",
  "id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "url": "https://example.com/hooks/todayfiles",
  "events": [
    "video.ready",
    "video.failed"
  ],
  "description": "Production",
  "enabled": true,
  "status": "active",
  "created_at": "2026-11-01T08:15:30Z",
  "updated_at": "2026-11-01T08:15:30Z",
  "last_delivery": null
}

Event

Name	Type	Required	Description
`object`	enum: event	Yes
`id`	string	Yes	Stable resource id.
`type`	enum: video.ready \| video.failed \| clone_job.completed \| ping	Yes
`created_at`	string (date-time)	Yes
`data`	object	Yes

JSON

{
  "object": "event",
  "id": "evt_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "type": "video.ready",
  "created_at": "2026-11-01T08:15:30Z",
  "data": {
    "video": {
      "object": "video",
      "id": "h87x",
      "title": "Launch trailer",
      "status": "ready",
      "processing": null,
      "failure": null,
      "source": "upload",
      "folder_id": "fld_3",
      "enabled": true,
      "disabled_by_moderation": false,
      "duration": 184,
      "size": 119248005,
      "max_height": 1080,
      "playback": {
        "player_url": "https://todayfiles-play.site/h87x",
        "embed_html": "\u003ciframe src=\"https://todayfiles-play.site/h87x\" width=\"100%\" height=\"100%\" frameborder=\"0\" allowfullscreen\u003e\u003c/iframe\u003e",
        "thumbnail_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/thumb.jpg",
        "poster_url": "https://todayfiles-play.site/img/k3q7wz2a/5x9a2k/poster.jpg"
      },
      "created_at": "2026-10-30T23:41:52Z",
      "updated_at": "2026-10-30T23:42:23Z"
    }
  }
}

Delivery

Name	Type	Required	Description
`object`	enum: delivery	Yes
`id`	string	Yes	Stable resource id.
`event_id`	string	Yes
`webhook_id`	string	Yes
`attempt`	integer	Yes
`status`	enum: pending \| succeeded \| failed	Yes
`response_status`	integer or null	Yes
`duration_ms`	integer or null	Yes
`error`	string	Yes
`next_attempt_at`	string or null	Yes
`created_at`	string (date-time)	Yes

JSON

{
  "object": "delivery",
  "id": "dlv_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "event_id": "evt_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "webhook_id": "wh_01jbqz5m3e6k8r9t2v4w6x8y0a",
  "attempt": 1,
  "status": "succeeded",
  "response_status": 200,
  "duration_ms": 120,
  "error": "",
  "next_attempt_at": null,
  "created_at": "2026-11-01T08:15:30Z"
}

Account

Name	Type	Required	Description
`object`	enum: account	Yes
`id`	string	Yes	Stable resource id.
`email`	string (email)	Yes
`username`	string	Yes
`clone_allowed`	boolean	Yes
`uploads`	object	Yes

JSON

{
  "object": "account",
  "id": "acct_7",
  "email": "you@example.com",
  "username": "demo",
  "clone_allowed": true,
  "uploads": {
    "max_bytes_per_file": 53687091200,
    "daily_limit": 100,
    "used_today": 3,
    "remaining_today": 97,
    "resets_at": "2026-11-02T00:00:00Z"
  }
}

List

Name	Type	Required
`object`	enum: list	Yes
`data`	array of object	Yes
`has_more`	boolean	Yes
`next_cursor`	string or null	Yes

JSON

{
  "object": "list",
  "data": [],
  "has_more": false,
  "next_cursor": null
}

Error

Name	Type	Required	Description	Example
`error`	object	Yes

JSON

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "title must be 1 to 200 characters.",
    "param": "title",
    "request_id": "req_3k7f2qzv8m1xw",
    "doc_url": "https://api.todayfiles.com/docs/errors#invalid_parameter"
  }
}