Delete GitHub tool connection¶

Delete GitHub tool connections and associated credentials saved in the current workspace. The interface returns a disconnected status even if there is no current connection.

HTTP
DELETE $CLOUDSIGMA_API_BASE/workspaces/{workspace_id}/tools/github/connect

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

The request body of this interface must be empty.

Request¶

Input examples

Shell
curl -X DELETE "$CLOUDSIGMA_API_BASE/workspaces/$WORKSPACE_ID/tools/github/connect" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

Parameter reference

Path parameters

Parameters	Type	Is it required	Description
`workspace_id`	string	Yes	The current workspace ID.

Successful response¶

Returns 200 on success. After disconnecting, subsequent GitHub tool calls can no longer use the deleted connection credentials.

Response example

JSON
{
  "code": 0,
  "data": {
    "tool_id": "moi.github.tools",
    "status": "disconnected",
    "requires_reconnect": false
  }
}

Field reference

The response fields are as follows.

Field	Type	Description
`code`	integer	`0` on success.
`data.tool_id`	string	GitHub built-in tool identifier.
`data.status`	string	`disconnected` after disconnection.
`data.requires_reconnect`	boolean	`false` after disconnection.

Error response¶

Response example

JSON
{
  "code": 2,
  "message": "<错误信息>"
}

Field reference

Common HTTP errors¶

HTTP status code	error code	Common causes	Recommended actions
`400`	`2`（`INVALID_ARGUMENT`）	Invalid workspace ID.	Check path parameters.
`401`	`6`（`UNAUTHENTICATED`）	Lack of valid identity credentials.	Check API Key.
`403`	`5`（`PERMISSION_DENIED`）	The current identity does not have permission to manage tool connections.	Check workspace authorization.
`503`	`15`（`UNAVAILABLE`）	The GitHub tool connection service or authorization dependency is temporarily unavailable.	Try again later.

Follow-up operations¶

Query tool tag, confirm that the target no longer appears.

Last updated on Sep 15, 2026