Update a Docs7 site - Context7 MCP

patch/v2/teamspaces/{teamspaceId}/sites/{siteId}

Request example

curl --request PATCH \
  --url https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "hosting": "on",
  "slug": "<string>",
  "analyticsUrl": "<string>",
  "customDomain": "<string>",
  "customDomainPath": "<string>",
  "customDomainRouting": "dns",
  "branch": "<string>",
  "docsPath": "<string>",
  "context7Index": true,
  "improveSchedule": "off",
  "pullRequestReview": {
    "enabled": true,
    "response": "comment"
  },
  "codeWatch": {
    "enabled": true,
    "repositories": [
      "<string>"
    ]
  },
  "buildFixSchedule": "off"
}'

import requests

url = "https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json",
}
payload = {
    "hosting": "on",
    "slug": "<string>",
    "analyticsUrl": "<string>",
    "customDomain": "<string>",
    "customDomainPath": "<string>",
    "customDomainRouting": "dns",
    "branch": "<string>",
    "docsPath": "<string>",
    "context7Index": True,
    "improveSchedule": "off",
    "pullRequestReview": {
        "enabled": True,
        "response": "comment"
    },
    "codeWatch": {
        "enabled": True,
        "repositories": [
            "<string>"
        ]
    },
    "buildFixSchedule": "off"
}

response = requests.request("PATCH", url, headers=headers, json=payload)

print(response.text)

const response = await fetch('https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "hosting": "on",
    "slug": "<string>",
    "analyticsUrl": "<string>",
    "customDomain": "<string>",
    "customDomainPath": "<string>",
    "customDomainRouting": "dns",
    "branch": "<string>",
    "docsPath": "<string>",
    "context7Index": true,
    "improveSchedule": "off",
    "pullRequestReview": {
      "enabled": true,
      "response": "comment"
    },
    "codeWatch": {
      "enabled": true,
      "repositories": [
        "<string>"
      ]
    },
    "buildFixSchedule": "off"
  })
});

const data = await response.json();
console.log(data);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'PATCH',
  CURLOPT_POSTFIELDS => '{
  "hosting": "on",
  "slug": "<string>",
  "analyticsUrl": "<string>",
  "customDomain": "<string>",
  "customDomainPath": "<string>",
  "customDomainRouting": "dns",
  "branch": "<string>",
  "docsPath": "<string>",
  "context7Index": true,
  "improveSchedule": "off",
  "pullRequestReview": {
    "enabled": true,
    "response": "comment"
  },
  "codeWatch": {
    "enabled": true,
    "repositories": [
      "<string>"
    ]
  },
  "buildFixSchedule": "off"
}',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer <token>',
    'Content-Type: application/json',
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

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

func main() {
	url := "https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}"
	payload := strings.NewReader("{\n  \"hosting\": \"on\",\n  \"slug\": \"<string>\",\n  \"analyticsUrl\": \"<string>\",\n  \"customDomain\": \"<string>\",\n  \"customDomainPath\": \"<string>\",\n  \"customDomainRouting\": \"dns\",\n  \"branch\": \"<string>\",\n  \"docsPath\": \"<string>\",\n  \"context7Index\": true,\n  \"improveSchedule\": \"off\",\n  \"pullRequestReview\": {\n    \"enabled\": true,\n    \"response\": \"comment\"\n  },\n  \"codeWatch\": {\n    \"enabled\": true,\n    \"repositories\": [\n      \"<string>\"\n    ]\n  },\n  \"buildFixSchedule\": \"off\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("{\n  \"hosting\": \"on\",\n  \"slug\": \"<string>\",\n  \"analyticsUrl\": \"<string>\",\n  \"customDomain\": \"<string>\",\n  \"customDomainPath\": \"<string>\",\n  \"customDomainRouting\": \"dns\",\n  \"branch\": \"<string>\",\n  \"docsPath\": \"<string>\",\n  \"context7Index\": true,\n  \"improveSchedule\": \"off\",\n  \"pullRequestReview\": {\n    \"enabled\": true,\n    \"response\": \"comment\"\n  },\n  \"codeWatch\": {\n    \"enabled\": true,\n    \"repositories\": [\n      \"<string>\"\n    ]\n  },\n  \"buildFixSchedule\": \"off\"\n}"))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

require 'uri'
require 'net/http'

url = URI('https://context7.com/api/v2/teamspaces/{teamspaceId}/sites/{siteId}')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = url.scheme == 'https'

request = Net::HTTP::Patch.new(url)
request['Authorization'] = 'Bearer <token>'
request['Content-Type'] = 'application/json'
request.body = '{
  "hosting": "on",
  "slug": "<string>",
  "analyticsUrl": "<string>",
  "customDomain": "<string>",
  "customDomainPath": "<string>",
  "customDomainRouting": "dns",
  "branch": "<string>",
  "docsPath": "<string>",
  "context7Index": true,
  "improveSchedule": "off",
  "pullRequestReview": {
    "enabled": true,
    "response": "comment"
  },
  "codeWatch": {
    "enabled": true,
    "repositories": [
      "<string>"
    ]
  },
  "buildFixSchedule": "off"
}'

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

Response

{
  "data": {
    "id": "<string>",
    "projectId": "<string>",
    "createdBy": "<string>",
    "repoUrl": "<string>",
    "repositoryId": "<string>",
    "installationId": 1,
    "branch": "<string>",
    "defaultBranch": "<string>",
    "docsPath": "<string>",
    "hosting": "off",
    "analyticsUrl": "<string>",
    "workerName": "<string>",
    "platformHostname": "acme-docs.docs7.io",
    "customDomain": "<string>",
    "customDomainPath": "<string>",
    "customDomainRouting": "dns",
    "customHostnameId": "<string>",
    "customDomainStatus": "none",
    "customDomainError": "<string>",
    "customDomainRecords": [
      {
        "purpose": "domain_ownership",
        "type": "CNAME",
        "name": "<string>",
        "value": "<string>"
      }
    ],
    "context7Index": true,
    "context7LibraryName": "/acme/docs",
    "improveSchedule": "off",
    "pullRequestReview": {
      "enabled": true,
      "response": "comment"
    },
    "codeWatch": {
      "enabled": true,
      "repositories": [
        {
          "repositoryId": "<string>",
          "repoUrl": "<string>"
        }
      ]
    },
    "createdAt": "2026-08-10T12:00:00Z",
    "updatedAt": "2026-08-10T12:00:00Z",
    "buildFixSchedule": "off"
  },
  "deploymentId": "<string>",
  "context7Notice": "<string>"
}

{
  "error": "invalid_payload"
}

{
  "error": "unauthorized",
  "message": "Authentication required."
}

{
  "error": "docs7_pro_required"
}

{
  "error": "not_found",
  "message": "Site not found."
}

{
  "error": "slug_conflict"
}

{
  "error": "internal_error",
  "message": "Internal server error."
}

{
  "error": "site_update_failed"
}

patch/v2/teamspaces/{teamspaceId}/sites/{siteId}

Authorization

Authorizationstringheaderrequired#

Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely.

Path parameters

teamspaceIdstringrequired#

Teamspace id.

siteIdstringrequired#

Docs7 site id.

Body

application/json

hostingenum<string>#

Publish a site added for the agents only. One way; delete the site to stop publishing. The only field a developer can send.

Options:on

slugstring#

Length: 3–40

analyticsUrlstring#

customDomainstring#

customDomainPathstring#

customDomainRoutingenum<string>#

Options:dnsproxy

branchstring#

Length: 1–255

docsPathstring#

context7Indexboolean#

improveScheduleenum<string>#

Options:offdailyweekly

pullRequestReviewobject#

PR Review Agent settings.

Show child attributes

enabledbooleanrequired#

responseenum<string>required#

What the agent does with its fixes. The findings comment is always posted, and every check always runs.

Options:commentpull_requestcommit

codeWatchobject#

Show child attributes

enabledbooleanrequired#

repositoriesstring[]required#

GitHub repository URLs. Each new one is checked against the site's GitHub App installation and the caller's GitHub access.

Items: max 50

buildFixScheduleenum<string>#

When the Build Fix Agent fixes the issues of the latest production build (hosted sites).

Options:offafter_builddailyweekly

Responses

application/json

The updated site

dataobjectrequired#

A Docs7 site built from a GitHub repository.

Show child attributes

idstringrequired#

projectIdstringrequired#

Teamspace id.

createdBystring#

repoUrlstringrequired#

repositoryIdstring#

GitHub repository id.

installationIdinteger#

GitHub App installation id.

branchstring#

Pinned production branch. Null follows the default branch.

defaultBranchstring#

docsPathstringrequired#

Docs folder in the repository; . is the root.

hostingenum<string>required#

off: added for the agents only, nothing is published.

Options:offon

analyticsUrlstring#

External docs URL for browser analytics of a site that Docs7 does not host.

workerNamestring#

platformHostnamestringrequired#

customDomainstring#

customDomainPathstring#

Path prefix the docs are served under on the custom domain.

customDomainRoutingenum<string>#

Options:dnsproxy

customHostnameIdstring#

customDomainStatusenum<string>required#

Options:nonepending_ownershippending_dnspending_validationpending_certificatepending_proxyactivefailed

customDomainErrorstring#

customDomainRecordsobject[]#

Show child attributes

purposeenum<string>required#

Options:domain_ownershiptls_certificate

typeenum<string>required#

Options:CNAMETXT

namestringrequired#

valuestringrequired#

context7Indexbooleanrequired#

Whether the repository is indexed in Context7.

context7LibraryNamestring#

improveScheduleenum<string>required#

How often the Context7 Agent runs on its own.

Options:offdailyweekly

pullRequestReviewobject#

PR Review Agent settings.

Show child attributes

enabledbooleanrequired#

responseenum<string>required#

What the agent does with its fixes. The findings comment is always posted, and every check always runs.

Options:commentpull_requestcommit

codeWatchobject#

Code Watch Agent settings: code repositories whose merged pull requests can change the docs.

Show child attributes

enabledbooleanrequired#

repositoriesobject[]required#

Show child attributes

repositoryIdstringrequired#

repoUrlstringrequired#

createdAtstringrequired#

updatedAtstringrequired#

buildFixScheduleenum<string>#

When the Build Fix Agent fixes the issues of the latest production build (hosted sites).

Options:offafter_builddailyweekly

deploymentIdstringrequired#

The first build when this call published the site.

context7Noticestringrequired#

Why Context7 could not index the repository, when context7Index was turned on but the library cannot refresh.

Delete a Docs7 site Check a custom domain again