---
title: "Attestation Create Federation"
method: POST
path: "/v1/cvm/federations"
tags: ["CVM Attestation"]
---

# Attestation Create Federation

`POST /v1/cvm/federations`

Create a federation and reserve a new set of node IDs.

## Headers

- `authorization` string, nullable

## Request body

- FederationCreateRequest — Request schema for federation create.
  - `node_count` integer, required — Number of nodes to reserve for the new federation.

## Response `201`

Successful Response

- FederationCreateResponse — Response schema for creating federation.
  - `federation_id` string, required
  - `node_ids` integer[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/flower/apis/superlink-api.md) · [All operations](https://skmtc.dev/flower/apis/superlink-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flower/superlink-api/revisions/adf853ac4f41/schema)