Files
openwork/packages/docs/worker-runtime-upgrades.mdx
2026-03-11 18:30:50 -07:00

56 lines
1.2 KiB
Plaintext

---
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.