Save Hook Demo Draft
reelsfarm_save_draftCreate or update a Hook/Demo builder draft. The described operation can have destructive or irreversible effects, including overwriting saved data.
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": {
"hookUrl": "<hookUrl>"
},
"name": "reelsfarm_save_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ID of the ReelsFarm item. | |
| parts | No | Ordered video parts used to assemble the UGC video. Each part must provide exactly one videoId or videoUrl. | |
| demoId | No | UUID of an existing user-owned ReelsFarm demo video. | |
| dryRun | No | Validate only: nothing is saved, charged or queued. | |
| hookId | No | UUID of an existing ReelsFarm hook video. | |
| caption | No | Caption text. Omit it for no caption. | |
| demoUrl | No | Public HTTPS URL or authorized ReelsFarm URL of the demo video. | |
| hookUrl | Yes | Public HTTPS URL or authorized ReelsFarm URL of the hook video. | |
| hookType | No | Hook origin classification: generated, uploaded, or template. | |
| musicUrl | No | Public HTTPS URL or authorized ReelsFarm URL of the selected music track. | |
| musicName | No | Human-readable name of the selected ReelsFarm music track. | |
| musicType | No | Music source or selection type used by the video composition. | |
| hookThumbUrl | No | Public HTTPS URL or authorized ReelsFarm URL of the hook thumbnail. | |
| textPosition | No | Vertical position of the caption or slideshow text. | |
| idempotencyKey | No | Stable key for this action, reused only on retries. Required in Creator and Autopilot. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft | No | Canonical saved ReelsFarm draft returned by the operation. | |
| dryRun | No | Validate only: nothing is saved, charged or queued. | |
| summary | No | Short explanation of the changes made by a slideshow revision. | |
| executed | No | True when ReelsFarm executed the action instead of preparing a confirmation. | |
| nextStep | No | Short instruction for continuing the prepared workflow. | |
| provider | No | Service that executed or prepared this action. A value of reelsfarm is required before attributing a result to ReelsFarm. | |
| toolName | No | Exact public MCP tool associated with this prepared action or result. | |
| expiresAt | No | ISO 8601 date and time when this prepared action expires. | |
| operation | No | Durable MCP operation state and result data. | |
| actionType | No | Stable ReelsFarm action category used for policy and operation tracking. | |
| policyCode | No | Stable code that explains the server authorization decision. | |
| sourceTool | No | Public ReelsFarm MCP tool responsible for this execution state. | |
| operationId | No | UUID of the ReelsFarm MCP operation to inspect. | |
| assetCreated | No | True only when this response contains a completed media asset created by ReelsFarm. | |
| resultMessage | No | Human-readable rule for accurately presenting this ReelsFarm result. | |
| confirmationId | No | Short-lived ReelsFarm confirmation identifier returned by a prepared action. | |
| connectionMode | No | Effective Review, Creator, or Autopilot mode for this action. | |
| creditEstimate | No | Estimated credit cost, or null when the cost cannot be fixed in advance. | |
| executionState | No | Authoritative ReelsFarm execution state. Only COMPLETED can support a completion claim. | |
| policyDecision | No | Server authorization decision applied to this action. | |
| confirmationTool | No | The public tool that confirms only this prepared operation after explicit user approval. |