<!-- Extension API v0 — pre-1.0. Interfaces may change without notice until P2 seals the custom-code format. First-party extensions track HEAD. -->

# `workspaces.refresh`

Rebuild the hosted sandbox on the current platform image: backup, destroy, revoke its token; the next use recreates it fresh.

- **method + path**: `POST /v1/workspaces/{ws}/refresh`
- **TR label**: Sandbox yenilendi
- **auth**: authenticated · scope gates: any of `admin` — “Erişim anahtarlarını yalnızca mağaza sahibi yönetebilir”
- **agentPolicy**: `owner` — owner sessions only — never callable by any token and never an MCP tool.
- **effects**: `provider`, `r2`, `db`
- **idempotency**: server — the platform derives the key
- **wraps**: — (no command inside)

Machine-readable body schema: [/schemas/routes/workspaces.refresh.json](/schemas/routes/workspaces.refresh.json).

## Body

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {}
}
```