Use your own script

Pass script_text when you start a run to speak your own text. The override applies to that run only — the stored workflow isn’t changed, so concurrent runs with different scripts never collide. This is the pattern for agent-style callers: configure a workflow once, then send text per request.

1
run = client.workflows.runs.start(
2
    workflow_id,
3
    script_text="Hello! Your meeting starts in ten minutes.",
4
    source_language="en-us",
5
).data

source_language is optional — omit it to use the workflow’s saved language. The workflow must have exactly one script node (a 422 explains it otherwise).

To change the voice or add languages instead, edit the workflow’s definition.

Related

• Run a workflow — start, watch, download
• Workflow — script and voice nodes