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

# Bulk Mesh Cutover

`POST /admin/mesh/cutover`

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.net/meganova/apis/fastapi.md) · [All operations](https://skmtc.net/meganova/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meganova/fastapi/revisions/2b2bab8b9017/schema)