Python runs - Arga

Create a URL run

run = client.runs.create_url_run(
    url="https://staging.example.com",
    prompt="Test the checkout flow",
    credentials={"email": "test@example.com", "password": "pass"},
)

print(run.run_id, run.status)

The SDK also accepts optional twin and Scenario metadata for compatibility with the validation API. Provision and connect required twins before testing the application URL.

Get details

detail = client.runs.get(run.run_id)
print(detail.status)
print(detail.results_json)
print(detail.step_summaries)
print(detail.event_log_json)

Stream results

for event in client.runs.stream_results(run.run_id):
    print(event)

With AsyncArga:

async for event in client.runs.stream_results(run.run_id):
    print(event)

Wait for completion

detail = client.runs.wait(
    run.run_id,
    poll_interval=2.5,
    timeout=600,
)

Terminal statuses are completed, failed, and cancelled.

Cancel a run

client.runs.cancel(run.run_id)

Manual PR run compatibility

client.runs.create_pr_run(...) remains available for integrations using the legacy /validate/pr-run route. It does not guarantee a per-PR application deployment. New repository automation should be configured as PR Test Runs through the web app, CLI, or REST API.

⌘I