---
title: "Connect one project to a configured hub"
method: POST
path: "/api/v1/federation/bridges"
---

# Connect one project to a configured hub

`POST /api/v1/federation/bridges`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- ConnectFederationBridgeRequestBody
  - `actor` string
  - `hub_catalog` string, required
  - `hub_project` string, required
  - `preflight` boolean
  - `project_name` string, required
  - `serve_downstream` boolean
  - `signing_key_env` string: Daemon environment variable holding the signing secret.
  - `signing_key_file` string: Absolute path of an owner-only signing secret file on the daemon.
  - `signing_key_id` string

## Response `200`

OK

- FederationBridgeBody
  - `direction` 'bidirectional', required
  - `hub_catalog` string, required
  - `hub_instance_uid` string, required
  - `hub_links_checked` boolean, required: True when the hub confirmed the project has no cross-project issue links. False when the hub predates that check; connect can still fail if links exist.
  - `hub_project_id` integer, required
  - `hub_project_uid` string, required
  - `hub_url` string, required
  - `local_account` string, required
  - `project_id` integer
  - `project_name` string, required
  - `status` 'ready' | 'connected', required
  - `upstream_account` string, required

## Other responses

- `default`: Error

## Changes

- **2026-10-23** `6fffc8eece67`: 1 info
  - added the required property `hub_links_checked` to the response with the `200` status
- **2026-10-14** `c5792dd95eca`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/federation/bridges/post.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/351807923500?raw)