---
title: "Attach Team Installation"
method: POST
path: "/teams/{team_id}/installations"
tags: ["teams"]
---

# Attach Team Installation

`POST /teams/{team_id}/installations`

Attach an org GitHub App install to the team so every member can use it.

Owner/admin only, and the caller must be a verified admin of the GitHub org
the install belongs to — pass the Supabase session ``provider_token`` as
``X-GitHub-Token`` so the backend can cross-check the token's identity
before trusting the org-admin claim. Idempotent.

## Path parameters

- `team_id` string, required

## Headers

- `x-github-token` string, nullable

## Request body

- TeamInstallationAttachRequest
  - `installation_id` integer, required

## Response `200`

Successful Response

- TeamInstallationResponse
  - `team_id` string, required
  - `installation_id` integer, required
  - `linked_by` string, nullable
  - `created_at` string, date-time, nullable
  - `account_login` string, nullable
  - `account_type` string, nullable
  - `app_id` string, nullable
  - `suspended` boolean
  - `repos` TeamInstallationRepoResponse[]
    - `owner` string, required
    - `name` string, required
    - `full_name` string, required
    - `is_private` boolean
    - `default_branch` string

## Other responses

- `422` — Validation Error

---

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