---
title: "Bulk Mesh Cutover"
method: POST
path: "/admin/mesh/cutover"
tags: ["admin"]
---

# Bulk Mesh Cutover

`POST /admin/mesh/cutover`

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/admin/mesh/cutover`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Bulk-flip a set of agents to a new mesh backend.

Body:
{
  "agent_ids": ["uuid1", "uuid2", ...],  // omit to flip ALL published agents
  "mesh_backend": "nova" | "ang" | "shadow" | null
}

Use this to gradually migrate a subset of agents to Nova OS (shadow first,
then nova), or to roll back to ang if issues arise. Audit-logged.

## Request body

- object

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/meganova/apis/meganova-api.md) - [All operations](https://skmtc.dev/meganova/apis/meganova-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meganova/apis/meganova-api/revisions/c683584f6060?raw)