---
title: "Set an enrolled spoke's hub-local name"
method: PUT
path: "/api/v1/federation/enrollments/spokes/{spoke_instance_uid}/name"
---

# Set an enrolled spoke's hub-local name

`PUT /api/v1/federation/enrollments/spokes/{spoke_instance_uid}/name`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/kenn-io/apis/kata/docs/api/v1/federation/enrollments/spokes/:spoke_instance_uid/name/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `spoke_instance_uid` string, required

## Request body

- SetFederationSpokeNameRequestBody
  - `name` string, required: Lowercase spoke name: a letter, then up to 31 lowercase letters, digits or hyphens.

## Response `200`

OK

- FederationSpokeNameOut
  - `spoke_instance_uid` string, required
  - `spoke_name` string

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `051dceffde4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/federation/enrollments/spokes/:spoke_instance_uid/name/put.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) - [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) - [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/f9c29d9b41e3?raw)