Is there a supported API for rill project refresh?

[rish-hyun]

Hi team,

I’ve been exploring ways to programmatically trigger a metrics view refresh without using the CLI directly.

Currently, I’m using:

rill project refresh --metrics-view <metrics_view>

from the Rill CLI successfully.

While looking for a Python-native approach, I found the pyrill repository:
https://github.com/rilldata/pyrill

However, I could not find support for:

• refreshing/reconciling metrics views
• triggering project/model refreshes
• runtime reconciliation APIs

From inspecting the codebase, it seems the CLI internally uses gRPC/protobuf runtime APIs rather than a documented REST interface.

So I wanted to ask:

1. Does a supported programmatic API currently exist for triggering:

   • metrics view refresh
   • model refresh
   • project reconcile/refresh

2. If yes:

   • is there any documentation/examples available?
   • is pyrill intended to support these operations?

3. If not:

   • are there plans to expose this functionality via:

     • Python SDK
     • REST API
     • public gRPC client
       in the future?

My use case is exposing a FastAPI endpoint internally that can trigger refreshes programmatically without shelling out to the CLI.

Right now, wrapping the CLI via subprocess seems like the most stable option, but I wanted to confirm whether there’s an officially recommended alternative.

Thanks!