Stability Level Preview

The parentOrganizations() GraphQL query will get a list of linked parent organizations.

To link or unlink an organization to another, to make one a child of a parent, use the linkChildOrganization() and unlinkChildOrganization() mutation fields. Use the childOrganizations() query field for information on a child organization.

To get information on an organization, you can use the organization() query field. To access the same data through the UI, see Organization Settings in the main documentation.

Related to this query, there is the searchOrganizations() and childOrganizations() query fields. There are also the linkChildOrganization() and unlinkChildOrganization() mutation fields.

Syntax

graphql
parentOrganizations(
      search: string, 
      limit: integer!,
      skip: integer!, 
      orderBy: OrderBy, 
      sortBy: OrganizationsLinks__SortBy
   ): ParentOrganizationsResultSet!

For sortBy is a special datatype (see Given Datatypes below), but it's not required. The default value for it is Name. For orderBy, the default value for OrderBy is ASC. These two special datatypes are described in the Given Datatypes section.

For the other input parameters, which don't use special datatypes, there are some values assumed. The default for limit is 50. For skip, it's 0.

For the results, besides a total count of the results, you can get details on parent organizations (e.g., the organizations' configuration and URLs, any organization limits). See the Returned Datatype section further down this page for more on this — and a link to sub-parameters.

Example

Below is an example of how this query field might be used:

Raw
graphql
query {
  parentOrganizations(
    search: "abc123", 
    skip: 0,
    limit: 50,
    orderBy: ASC,
    sortBy: Name )    
   { totalResults,
      results { id } }
}
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" : "query {
  parentOrganizations(
    search: \"abc123\", 
    skip: 0,
    limit: 50,
    orderBy: ASC,
    sortBy: Name )    
   { totalResults,
      results { id } }
}"
}
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" : "query {
  parentOrganizations(
    search: \"abc123\", 
    skip: 0,
    limit: 50,
    orderBy: ASC,
    sortBy: Name )    
   { totalResults,
      results { id } }
}"
}
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" : "query { ^
  parentOrganizations( ^
    search: \"abc123\",  ^
    skip: 0, ^
    limit: 50, ^
    orderBy: ASC, ^
    sortBy: Name )     ^
   { totalResults, ^
      results { id } } ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "query {
  parentOrganizations(
    search: \"abc123\", 
    skip: 0,
    limit: 50,
    orderBy: ASC,
    sortBy: Name )    
   { totalResults,
      results { id } }
}"
}'
    "$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 = "query {
  parentOrganizations(
    search: \"abc123\", 
    skip: 0,
    limit: 50,
    orderBy: ASC,
    sortBy: Name )    
   { totalResults,
      results { id } }
}";
$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" : "query {
  parentOrganizations(
    search: \"abc123\", 
    skip: 0,
    limit: 50,
    orderBy: ASC,
    sortBy: Name )    
   { totalResults,
      results { id } }
}"
}'''

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" : "query {
  parentOrganizations(
    search: \"abc123\", 
    skip: 0,
    limit: 50,
    orderBy: ASC,
    sortBy: Name )    
   { totalResults,
      results { id } }
}"
}
);


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": {
    "parentOrganizations": {
      "totalResults": "1",
      "results":  {
         "id": "def456"
      }
    }
  }
}

Given Datatypes

You can sort the results found by some identifying element (e.g., organization name). This allows you to group results. The choices for sorting is listed here along with descriptions of each:

Table: OrganizationsLinks__SortBy

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: Jul 25, 2025
Cid   PreviewSort by CID for the organization.
OrgId   PreviewSort by the unique identifier for the organization.
Name  ✓PreviewSort by the name of the organization.

In addition to sorting, you can then return results by either ascending or descending order.

Table: OrderBy

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: Oct 10, 2025
ASC  ✓Long-TermOrder results in ascending order (e.g., 0 to 9, A to Z).
DESC   Long-TermOrder results in descending order (e.g., 9 to 0, Z to A).

Returned Datatype

For the results, besides a total count of the results, you can get details on the parent organizations found, such as the organizations' configurations and URLs, any organization limits. The table below lists what's possible:

Table: ParentOrganizationsResultSet

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: May 2, 2025
results[Organization]yes PreviewThe paginated result set. See Organization.
totalResultsintegeryes PreviewThe total number of matching results.