Presigned URLs for the parts of a video upload that media.requestUpload started in multipart mode. Each URL accepts one PUT of part_size bytes (the last part may be shorter) and expires in 20 minutes. Ask again for the next parts. The server never sees the bytes.
| |
|---|
| Who | Agents can call this |
| REST | POST /v1/media/video-parts |
| MCP tool | media_videoPartUrls |
| Writes | no |
| Area | Shop |
When to use it
Presigned URLs for the parts of a video upload that media.requestUpload started in multipart mode. Each URL accepts one PUT of part_size bytes (the last part may be shorter) and expires in 20 minutes.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
| Field | Type | Required |
|---|
upload_token | string | yes |
part_numbers | array | yes |
Example
POST https://doingwork.work/v1/media/video-parts
content-type: application/json
Idempotency-Key: 3f1c...
{
"upload_token": "...",
"part_numbers": [
1
]
}
Output
| Field | Type | Always there |
|---|
part_size | integer | yes |
urls | array | yes |
urls[].part_number | integer | yes |
urls[].url | string | yes |
{
"part_size": 1,
"urls": [
{
"part_number": 1,
"url": "https://example.com/hooks/doing-work"
}
]
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |