---
title: "Rename or delete a session group"
method: POST
path: "/api/session-moves/prefix"
tags: ["Sessions"]
---

# Rename or delete a session group

`POST /api/session-moves/prefix`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/session-moves/prefix`
- Auth: HTTP bearer

## Request body

- object
  - `from` string, required: Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.
  - `to` string, nullable, required: Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.

## Response `200`

Moved and skipped sessions and remaining movable roots

- object
  - `moved` string[], required
  - `skipped` object[], required
    - `rootTaskId` string, required
    - `reason` string, required
  - `remaining` integer, required

## Other responses

- `400`: Invalid namespace or request
- `403`: Personal destination not authorized
- `409`: Moves blocked until audit warnings are repaired

## Changes

- **2026-10-22** `a2e24c51a750`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/session-moves/prefix/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) - [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)