---
title: "Create a federation enrollment"
method: POST
path: "/api/v1/federation/enrollments"
---

# Create a federation enrollment

`POST /api/v1/federation/enrollments`

Creates a hub-side transport grant. When the request includes a caller-supplied token, an exact retry returns the same active enrollment; reusing that token for different attributes or after revocation returns 409.

## Request body

- CreateFederationEnrollmentRequestBody
  - `actor` string
  - `allow_adoption_snapshot_authors` boolean
  - `capabilities` string, required
  - `project_id` integer, nullable, required
  - `spoke_instance_uid` string, required
  - `token` string

## Response `200`

OK

- FederationEnrollmentOut
  - `actor` string, required
  - `capabilities` string, required
  - `created_at` string, date-time, required
  - `id` integer, required
  - `project_id` integer, nullable, required
  - `revoked_at` string, date-time
  - `spoke_instance_uid` string, required
  - `token` string
  - `updated_at` string, date-time, required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/kenn-io/apis/kata.md) · [All operations](https://skmtc.net/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenn-io/kata/versions/d8237a47d2fc/schema)