Add recording
add_recordingImport a public video or audio file from a direct URL as a new recording and start generating clips from it; use the returned recording ID and status to track processing.
Instructions
Brings in an existing video or audio file from a direct link as a new recording and starts editing it into clips, which takes several minutes. Counts against the account's recording allowance. Returns the new recording's id and status.
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": {
"media_url": "<media_url>",
"idempotency_key": "<idempotency_key>"
},
"name": "add_recording"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| media_url | Yes | Public https link that points directly at a video or audio file, up to 1 GB. | |
| account_id | No | ||
| instruction | No | Optional guidance for the edit, such as which topics to cut clips from. | |
| idempotency_key | Yes |