Beta

API ReferenceFile

Upload YouTube File

POSThttps://api.youvico.com/api/projects/:id/files/upload.youtube
MCP Tool
import_youtube_fileImport YouTube Video
Rate Limit
Tier 2
Scope
files:write
Project Role
OwnerManagerMember

Adds a YouTube video as a file.

Example

curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files/upload.youtube' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }'

{
  "data": {
    "id": "FX1234567890ABCD"
  }
}
Request
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files/upload.youtube' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}'
Response201 Created
{
  "data": {
    "id": "FX1234567890ABCD"
  }
}

Request

Path

idstringrequired
Project ID

Body

urlstringrequired

URL

YouTube video URL

Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Response

Returns 201 Created.

dataobject
Created file
data.idstring
ID of the created file

Example: FX1234567890ABCD