Summary

The disconnectRemoteTableConfig() GraphQL mutation is used to disconnect a remote table from a view. It doesn't eliminate the table, just the connection.

Stability Level Preview

Syntax

graphql
disconnectRemoteTableConfig(
     input: ConnectRemoteTableConfigInput!
   ): RemoteTableConfig!

For the input, you'd enter the name of the view and connection related to the remote table. See the Input Parameters section.

In return, you can get the configuration and URL. However, that table will no longer be connected. See the Returned Values section for more.

Example

Raw
graphql
mutation {
  disconnectRemoteTableConfig(
    input: { 
       viewName: "our_view",
       connectionName: "remote_table" }
  ) { connectionDescription }
}
Mac OS or Linux (curl)
shell
curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "mutation {
  disconnectRemoteTableConfig(
    input: { 
       viewName: \"our_view\",
       connectionName: \"remote_table\" }
  ) { connectionDescription }
}"
}
EOF
Mac OS or Linux (curl) One-line
shell
curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "mutation {
  disconnectRemoteTableConfig(
    input: { 
       viewName: \"our_view\",
       connectionName: \"remote_table\" }
  ) { connectionDescription }
}"
}
EOF
Windows Cmd and curl
shell
curl -v -X POST $YOUR_LOGSCALE_URL/graphql ^
    -H "Authorization: Bearer $TOKEN" ^
    -H "Content-Type: application/json" ^
    -d @'{"query" : "mutation { ^
  disconnectRemoteTableConfig( ^
    input: {  ^
       viewName: \"our_view\", ^
       connectionName: \"remote_table\" } ^
  ) { connectionDescription } ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  disconnectRemoteTableConfig(
    input: { 
       viewName: \"our_view\",
       connectionName: \"remote_table\" }
  ) { connectionDescription }
}"
}'
    "$YOUR_LOGSCALE_URL/graphql"
Perl
perl
#!/usr/bin/perl

use HTTP::Request;
use LWP;

my $TOKEN = "TOKEN";

my $uri = '$YOUR_LOGSCALE_URL/graphql';

my $query = "mutation {
  disconnectRemoteTableConfig(
    input: { 
       viewName: \"our_view\",
       connectionName: \"remote_table\" }
  ) { connectionDescription }
}";
$query =~ s/\n/ /g;
my $json = sprintf('{"query" : "%s"}',$query);
my $req = HTTP::Request->new("POST", $uri );

$req->header("Authorization" => "Bearer $TOKEN");
$req->header("Content-Type" => "application/json");

$req->content( $json );

my $lwp = LWP::UserAgent->new;

my $result = $lwp->request( $req );

print $result->{"_content"},"\n";
Python
python
#! /usr/local/bin/python3

import requests

url = '$YOUR_LOGSCALE_URL/graphql'
mydata = r'''{"query" : "mutation {
  disconnectRemoteTableConfig(
    input: { 
       viewName: \"our_view\",
       connectionName: \"remote_table\" }
  ) { connectionDescription }
}"
}'''

resp = requests.post(url,
                     data = mydata,
                     headers = {
   "Authorization" : "Bearer $TOKEN",
   "Content-Type" : "application/json"
}
)

print(resp.text)
Node.js
javascript
const https = require('https');

const data = JSON.stringify(
    {"query" : "mutation {
  disconnectRemoteTableConfig(
    input: { 
       viewName: \"our_view\",
       connectionName: \"remote_table\" }
  ) { connectionDescription }
}"
}
);


const options = {
  hostname: '$YOUR_LOGSCALE_URL',
  path: 'graphql',
  port: 443,
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': data.length,
    Authorization: 'BEARER ' + process.env.TOKEN,
    'User-Agent': 'Node',
  },
};

const req = https.request(options, (res) => {
  let data = '';
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', (d) => {
    data += d;
  });
  res.on('end', () => {
    console.log(JSON.parse(data).data);
  });
});

req.on('error', (error) => {
  console.error(error);
});

req.write(data);
req.end();
Example Responses
Success (HTTP Response Code 200 OK)
json
{
  "data": {
    "disconnectRemoteTableConfig": {
      "connectionDescription": "Out of the Way Table"
    }
  }
}

The example here shows how you might use this mutation field to disconnect a remote table from a view.

Input Parameters

With this input datatype, you would provide the name of the view and the name of the remote table configuration you want to disconnect. These parameters are listed and described below:

Table: ConnectRemoteTableConfigInput Input Datatype

ParameterTypeRequiredDefaultStabilityDescription
Some input parameters may be required, as indicated in the Required column. For return values, this indicates that you are assured a value if the field is requested for the results.
Table last updated: Jan 26, 2026
connectionNamestringyes PreviewThe name of the remote table configuration.
viewNamestringyes PreviewThe name of the view to add the remote table configuration.

Returned Values

With the return datatype and sub-datatype, you can get the URL and the configuration of a remote table. These are partly described in the table below, but you'll have to click on the one special datatype and further for more details.

Table: RemoteTableConfig Datatype

ParameterTypeRequiredDefaultStabilityDescription
Some input parameters may be required, as indicated in the Required column. For return values, this indicates that you are assured a value if the field is requested for the results.
Table last updated: Feb 16, 2026
accessRequirementRemoteTableAccessRequirementyes PreviewAn access requirement needed to run a remote table query based on this configuration. See RemoteTableAccessRequirement.
connectionConfigRemoteTableGenericConnectionSensitiveConfigyes PreviewThe configuration of the remote table connection. See RemoteTableGenericConnectionSensitiveConfig.
connectionDescriptionstringyes PreviewThe description of the remote table configuration.
connectionNamestringyes PreviewThe name of the remote table connection.
viewIds[string]yes PreviewThe identifiers for the views to which the configuration is connected.