---
title: "Connect a project to the flags of this project"
method: PUT
path: "/v1/projects/{projectIdOrName}/feature-flags/connections"
tags: ["feature-flags"]
---

# Connect a project to the flags of this project

`PUT /v1/projects/{projectIdOrName}/feature-flags/connections`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/projects/{projectIdOrName}/feature-flags/connections`
- Auth: HTTP bearer

Connects a project in the same team to the flags of this project. The consumer project reads this project's flags with its own deployment identity by naming this project in the Flags SDK. Connections grant read and evaluate access across environments, with the consumer deployment's environment selecting the source environment. Requires connection management permission on the source project and read access to the consumer project.

## Path parameters

- `projectIdOrName` string, required: The project id or name

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `consumerProjectId` string, required: The project in the same team that may read the flags of this project

## Response `200`

- object
  - `consumerProjectId` string, required
  - `consumerProjectName` string, required
  - `createdAt` number, required
  - `createdBy` string, required
  - `sourceProjectId` string, required
  - `sourceProjectName` string, required

## Other responses

- `400`: One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `402`: The account is missing a payment so payment method must be updated
- `403`: You do not have permission to access this resource.
- `404`
- `409`
- `410`
- `503`

## Changes

- **2026-11-02** `8b798b90939b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/projects/:projectIdOrName/feature-flags/connections/put.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)