Skip to article
Documentation

Search documentation

Search stays in this browser. Queries are not sent or saved. Do not paste credentials.

Loading the public search index…

Tab or arrow keys to navigate · Enter to open · Esc to close
Browse documentation

Prepare video upload

Source-generated prepare_video_upload arguments, output schema, OAuth scope, and safety annotations for the reviewed MCP contract.

Public betaLast verified
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

json
{
  "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.

VideoUploadSession

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.

Standard workflow · Spending safeguards

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

Need a hand? Contact support