Disconnect Repository

curl --request DELETE \
  --url https://api.example.com/api/v1/repos/{owner}/{repo}/install

const options = {method: 'DELETE'};

fetch('https://api.example.com/api/v1/repos/{owner}/{repo}/install', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/repos/{owner}/{repo}/install",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/repos/{owner}/{repo}/install"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/repos/{owner}/{repo}/install")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "repo": "<string>"
}

DELETE

api

repos

{owner}

{repo}

install

Disconnect Repository

curl --request DELETE \
  --url https://api.example.com/api/v1/repos/{owner}/{repo}/install

const options = {method: 'DELETE'};

fetch('https://api.example.com/api/v1/repos/{owner}/{repo}/install', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/repos/{owner}/{repo}/install",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/repos/{owner}/{repo}/install"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/repos/{owner}/{repo}/install")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "repo": "<string>"
}

Overview

Disconnects a repository from Nectr AI by removing the GitHub webhook and marking the installation as inactive. After disconnection, PR events from this repository will no longer trigger AI reviews.

Authentication

Requires a valid JWT token in the Authorization header.

Authorization: Bearer <token>

Path Parameters

string

required

Repository owner (user or organization)

string

required

Repository name

Request

curl -X DELETE "https://api.nectr.ai/api/v1/repos/acme/my-backend/install" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

import httpx

headers = {
    "Authorization": "Bearer YOUR_JWT_TOKEN"
}

response = httpx.delete(
    "https://api.nectr.ai/api/v1/repos/acme/my-backend/install",
    headers=headers
)
result = response.json()

const response = await fetch(
  'https://api.nectr.ai/api/v1/repos/acme/my-backend/install',
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer YOUR_JWT_TOKEN'
    }
  }
);

const result = await response.json();

Response

string

Always returns "disconnected" on success

string

Full repository name in owner/repo format

Example Response

{
  "status": "disconnected",
  "repo": "acme/my-backend"
}

What Happens During Disconnection

1. Webhook Removal

If the installation has a webhook_id, the endpoint attempts to delete the webhook from GitHub using:

DELETE https://api.github.com/repos/{owner}/{repo}/hooks/{webhook_id}

Graceful Degradation: If webhook removal fails (e.g., webhook already deleted manually on GitHub, or user lost admin access), a warning is logged but the disconnection proceeds.

2. Installation Deactivation

The Installation record is marked as inactive:

installation.is_active = False

The record is not deleted from the database, preserving historical data.

3. Data Retention

Preserved:

Installation record (marked is_active = False)
Neo4j code graph (Repository, File, PullRequest, Developer nodes)
Historical PR review data

Effect:

No new webhook events will be processed
Repository will show as disconnected in /api/v1/repos
User can reconnect later without data loss

Error Responses

JWT token is invalid, expired, or missing

{
  "detail": "Unauthorized"
}

GitHub OAuth token cannot be decrypted (SECRET_KEY changed)

{
  "detail": "Session expired — please log out and sign in again."
}

No active installation found for this repository and user

{
  "detail": "Installation not found"
}

This can occur if:

The repository was never connected
The repository is already disconnected
The repository belongs to a different user

Webhook Removal Failure Scenarios

The endpoint handles webhook deletion gracefully:

Scenario	Behavior
Webhook deleted manually on GitHub	Warning logged, disconnection succeeds
User lost admin permissions	Warning logged, disconnection succeeds
GitHub API unavailable	Warning logged, disconnection succeeds
Network timeout	Warning logged, disconnection succeeds

In all cases, the installation is marked inactive, preventing future webhook events from being processed.

Permissions Required

GitHub OAuth Scopes

repo - Required to delete webhooks

Repository Access

The authenticated user must have admin permissions on the repository to remove webhooks. If permissions are lost, webhook removal will fail gracefully.

Reconnection

After disconnection, you can reconnect the same repository using the Connect Repository endpoint. The previous installation record will remain inactive, and a new active installation will be created.

List Repositories - View connection status
Connect Repository - Reconnect a disconnected repository
Rescan Repository - Rebuild the code graph for an active connection

Connect Repository

Rescan Repository

⌘I

Authentication

Repositories

Reviews

Events

Analytics

Memory

Webhooks

MCP Server

Disconnect Repository

Overview

Authentication

Path Parameters

Request

Response

Example Response

What Happens During Disconnection

1. Webhook Removal

2. Installation Deactivation

3. Data Retention

Error Responses

Webhook Removal Failure Scenarios

Permissions Required

GitHub OAuth Scopes

Repository Access

Reconnection

​Overview

​Authentication

​Path Parameters

​Request

​Response

​Example Response

​What Happens During Disconnection

​1. Webhook Removal

​2. Installation Deactivation

​3. Data Retention

​Error Responses

​Webhook Removal Failure Scenarios

​Permissions Required

​GitHub OAuth Scopes

​Repository Access

​Reconnection

​Related Endpoints

Overview

Authentication

Path Parameters

Request

Response

Example Response

What Happens During Disconnection

1. Webhook Removal

2. Installation Deactivation

3. Data Retention

Error Responses

Webhook Removal Failure Scenarios

Permissions Required

GitHub OAuth Scopes

Repository Access

Reconnection

Related Endpoints