Prepare video upload
Source-generated prepare_video_upload arguments, output schema, OAuth scope, and safety annotations for the reviewed MCP contract.
On this page
Tool
prepare_video_upload
Prepare a private MP4/MOV/WebM reference upload, at most 100 MiB and 30 seconds. PUT the exact bytes using the returned URL/headers, then complete_video_upload. Starts no depth processing or generation.
Permissions and safety
OAuth scope: files:write
| Signal | Value |
|---|---|
destructiveHint |
false |
idempotentHint |
false |
openWorldHint |
true |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | temporary_upload_created |
Annotations describe safety properties; they do not replace consent, OAuth authorization, or server checks.
Input arguments
| Field | Type | Required | Default | Constraints | Meaning |
|---|---|---|---|---|---|
request |
VideoUploadRequest | Yes | — | — | — |
Argument example
{
"request": {
"byte_size": 1024,
"filename": "motion.mp4",
"mime_type": "video/mp4"
}
}
Structured result
| Field | Type | Required | Default | Constraints | Meaning |
|---|---|---|---|---|---|
expires_at |
string |
Yes | — | format: date-time |
Upload session expiry in UTC. |
headers |
object |
Yes | — | — | Use these exact headers for byte transfer. |
max_bytes |
integer |
Yes | — | — | Source byte limit. |
method |
string |
No | "PUT" |
const: "PUT" |
— |
upload_id |
string |
Yes | — | format: uuid |
Session to complete after transferring bytes; not usable as a video input yet. |
upload_url |
string |
Yes | — | — | Sensitive short-lived upload URL. Transfer bytes without API/OAuth credentials. |
Errors and next steps
Tool errors contain an error object with code, message, retryable, request_id, and details. Do not parse message text or leak private inputs. Inspect partial outputs after a terminal failure; a signed URL is not a saved file.
Was this page helpful?
No search queries, code, or free text are collected. This switch controls documentation interactions only; general site analytics follow the privacy policy. Privacy policy