Quote or prepare a ready workflow stage
playground_workflow_runRun a saved workflow through its ready image/video/audio stages. quote:true prices up to 20 ready nodes including connected List batches. Pass the returned stageNodeIds, expectedRevision, quoteId and a NEW idempotencyKey with quote:false to prepare chat confirmation. Does not auto-approve or dispatch dependent stages. After existing jobs settle, inspect/quote the next stage until completed. Preserve completed, active and uncertain work; no Berrys-agent delegation is needed. Returns a stage quote or execution/approval result with run and job tracking information.
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": {
"projectId": "<projectId>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "playground_workflow_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quote | No | When true, return pricing without executing paid generation; show the quote and obtain user approval before spending. | |
| quoteId | No | Exact quote ID returned by preparation or quoting; submit it with the unchanged quoted request. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| stageNodeIds | No | Ready-stage node IDs returned by the workflow quote for this execution. | |
| targetNodeIds | No | Workflow output node IDs to inspect or produce; dependencies are resolved from the graph. | |
| idempotencyKey | Yes | Unique key for this request; reuse only when retrying the identical request after a lost response. Use a new key after quoting or changing inputs. | |
| expectedRevision | Yes | Current canvas revision from canvas_read; on revision_conflict, read again and rebuild the change. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | Suggested next action; it does not authorize spending. | |
| error | No | ||
| items | No | ||
| nodes | No | ||
| runId | No | ||
| steps | No | ||
| inputs | No | ||
| reason | No | ||
| review | No | ||
| status | Yes | ||
| balance | No | ||
| credits | No | ||
| nodeIds | No | ||
| quoteId | No | ||
| replayed | No | ||
| revision | No | ||
| workflow | No | ||
| canvasUrl | No | ||
| execution | No | ||
| expiresAt | No | Serialized ISO timestamp. | |
| projectId | No | ||
| dispatchIds | No | ||
| confirmation | No | ||
| readyNodeIds | No | ||
| stageNodeIds | No | ||
| totalCredits | No | ||
| workflowNext | No | ||
| failedNodeIds | No | ||
| lockedNodeIds | No | ||
| validitySeconds | No | ||
| approvalLocation | No | ||
| completedNodeIds | No | ||
| expectedRevision | No | ||
| inputFingerprint | No | ||
| uncertainNodeIds | No | ||
| sufficientCredits | No | ||
| estimatedBalanceAfter | No |