---
title: "Promote a node to relay"
method: POST
path: "/scaleoutrelay/promote/{nodeId}"
tags: ["🧩 Scale out Relay"]
---

# Promote a node to relay

`POST /scaleoutrelay/promote/{nodeId}`

Promote a node to relay

## Path parameters

- `nodeId` string, uuid (or "root"), required

## Response `200`

Promote response

- object
  - `action` 'promoteToRelay', required — The id of the action
  - `result` 'success' | 'error', required — Result of the request
  - `data` string, required — Success or error message

---

[API](https://skmtc.net/rudder/apis/rudder-api.md) · [All operations](https://skmtc.net/rudder/apis/rudder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rudder/rudder-api/revisions/eab988254fba/schema)