create_run

Create a run record without starting execution

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Returns the run ID before execution begins. Pass it explicitly to run(function_run_id=...) to execute this run; run() without an ID creates a new run.

function = notte.Function("<your-function-id>")
created = function.create_run()
result = function.run(function_run_id=created.function_run_id, url="https://example.com")

run() still waits for completion. Creating a run does not launch a background job or change which run run() uses by default

Returns

CreateFunctionRunResponse