---
title: "Runtime upgrades"
description: "Inspect versions and refresh worker services"
---

Use this flow to check a Den worker's installed runtime versions and trigger an in-place service refresh.

---

## Inspect

Den exposes worker runtime inspection at:

- `GET /v1/workers/:id/runtime`

That endpoint proxies to the worker control endpoint:

- `GET /runtime/versions`

The response reports the worker runtime snapshot, including orchestrator metadata, service versions, and current upgrade state.

---

## Upgrade

Den exposes worker runtime upgrades at:

- `POST /v1/workers/:id/runtime/upgrade`

That endpoint proxies to the worker control endpoint:

- `POST /runtime/upgrade`

Default upgrades target:

- `openwork-server`
- `opencode`

You can also include `opencode-router` when that sidecar is enabled for the worker.

```json
{
  "services": ["openwork-server", "opencode", "opencode-router"]
}
```

---

## Know limits

This flow upgrades worker runtime services only. It does not upgrade `openwork-orchestrator` itself.

It also does not perform migration steps, worker-to-worker data moves, or a Render rebuild/redeploy.

A separate follow-up PR will document and add the fuller migration and worker handoff flow.
