Server-side handoff: give us a public https URL of the walkthrough instead of up
hand_off_videoServer-side handoff: give us a public https URL of the walkthrough instead of uploading it from a browser. Secret key only. We fetch it (up to 500 MB, streamed) and the job runs exactly as an upload would — poll GET /jobs/{id}. Needs the stored contact email and consent, like /upload-url. Replaces /upload-url, /upload-complete and /submit for a caller that already holds the file. A job whose fetch failed (error) may be handed a new URL. Counts toward the mover's daily analysis cap (429). Scope: jobs:write.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>",
"url": "<url>",
"consent": "<consent>"
},
"name": "hand_off_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public https URL that serves the video (a signed cloud-storage link is ideal). Private hosts and http are refused. | |
| job_id | Yes | The job id (ULID) | |
| consent | Yes | Must be true: the customer agrees the video will be analysed and shared with the mover. | |
| content_type | No | A video/* MIME type when you know it; otherwise the host's Content-Type must be video/* |