---
title: "Create a child cluster of this cluster"
method: POST
path: "/api/clusters/{clusterName}/actions/create-child"
tags: ["ClusterActions"]
---

# Create a child cluster of this cluster

`POST /api/clusters/{clusterName}/actions/create-child`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `Authorization`

Plans (confirm false) or creates (confirm true) a child cluster of {clusterName}, named <clusterName>-child unless a name is given, to test a migration under this cluster's writes: same orchestrator, database image unless dbImage is given (a newer release to test), DBU per node, accounts and proxy type, dbCount databases (default 2), GTID domain this cluster's + 1, this cluster as head cluster; provisioned, then seeded from this cluster's logical backup, data only, its master replicating from this cluster's master through the parent's replication-source-name and its replicas following it through the child's own (child). Needs cluster-replication on this cluster and the right to create a cluster. The progress is the state CINF0014 on the new cluster, WARN0239 where it stopped.

## Path parameters

- `clusterName` string, required

## Headers

- `Authorization` string, required

## Request body

- ServerChildRequest
  - `confirm` boolean: false: the plan only
  - `dbCount` integer: default 3 (staging), 2 (child)
  - `dbImage` string: default the parent's prov-db-image
  - `name` string: default <parent>-staging or <parent>-child

## Response `200`

The plan (confirm false)

- ServerChildPlan
  - `backup` string
  - `backupLogicalType` string: the parent's
  - `dbCount` integer
  - `dbImage` string
  - `dbuPerNode` integer
  - `domain` string: GTID domain: the parent's + 1
  - `kind` string
  - `name` string
  - `notes` string[]
  - `orchestrator` string
  - `ownSourceName` string: the new cluster's replication-source-name (its master to its replicas)
  - `parent` string
  - `proxy` string: "" = none
  - `sourceName` string: channel from the parent's master: the parent's replication-source-name

## Other responses

- `202`: Creation started (confirm true)
- `400`: Refused: the reason (no logical backup on the parent, orchestrator, name taken...)
- `403`: No valid ACL
- `404`: No cluster
- `500`: Created and kept, then stopped: the cluster name, the step and the reason (WARN0239)

## Changes

- **2026-10-12** `8ee8a1e31294`: 1 info
  - added the non-success response with the status `500`
- **2026-10-12** `1929d73dd60c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/changes/api/clusters/:clusterName/actions/create-child/post.md)

---

[API](https://skmtc.dev/signal18/apis/signal-18-dashboard-api.md) - [All operations](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/revisions/8ee8a1e31294?raw)