The enableFeatureForOrg() GraphQL mutation may be used to enable a feature for a specific organization in LogScale. To enable a feature for a single user, though, use enableFeatureForUser() .

For more information on enabling and disabling features, see the Enabling & Disabling Feature Flags reference page.

Syntax

Below is the syntax for the enableFeatureForOrg() mutation field:

graphql
enableFeatureForOrg(
      orgId: string!, 
      feature: FeatureFlag!,
      enableFeatureForOrg: boolean
   ): boolean!

To enable a feature for a single organization, enter something like the following:

Raw
graphql
mutation {
   enableFeatureForOrg(
     orgId: "organization-id", 
     feature: OneToManyGroupSynchronization
   )
}
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 {
   enableFeatureForOrg(
     orgId: \"organization-id\", 
     feature: OneToManyGroupSynchronization
   )
}"
}
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 {
   enableFeatureForOrg(
     orgId: \"organization-id\", 
     feature: OneToManyGroupSynchronization
   )
}"
}
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 { ^
   enableFeatureForOrg( ^
     orgId: \"organization-id\",  ^
     feature: OneToManyGroupSynchronization ^
   ) ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
   enableFeatureForOrg(
     orgId: \"organization-id\", 
     feature: OneToManyGroupSynchronization
   )
}"
}'
    "$YOUR_LOGSCALE_URL/graphql"
Perl
perl
#!/usr/bin/perl

use HTTP::Request;
use LWP;

my $INGEST_TOKEN = "TOKEN";

my $uri = '$YOUR_LOGSCALE_URL/graphql';

my $json = '{"query" : "mutation {
   enableFeatureForOrg(
     orgId: \"organization-id\", 
     feature: OneToManyGroupSynchronization
   )
}"
}';
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 {
   enableFeatureForOrg(
     orgId: \"organization-id\", 
     feature: OneToManyGroupSynchronization
   )
}"
}'''

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 {
   enableFeatureForOrg(
     orgId: \"organization-id\", 
     feature: OneToManyGroupSynchronization
   )
}"
}
);


const options = {
  hostname: '$YOUR_LOGSCALE_URL/graphql',
  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": {
    "enableFeatureForOrg": true
  }
}

Set skipVerification to true to skip verification. To enable a feature for a cluster, use instead enableFeature() .

Given Datatypes

For the given datatype, FeatureFlag, there are several parameters that may be given. The table below should list them. However, since they're all beta features, you'll have to click on the "Show Beta Features" button.

Table: FeatureFlag

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For some fields, this column indicates that a result will always be returned for this column.
Table last updated: Oct 9, 2024
AlternateQueryMergeTargetHandlingboolean   Allow alternate query merge target handling.
ArrayFunctionsboolean   Enable ArrayFunctions in query language.
AzureBlobStorageboolean   Enables support for Azure Blob Storage.
CachePoliciesboolean   Prioritize newer over older segments.
CancelQueriesExceedingAggregateOutputRowLimitboolean   When enabled, queries exceeding the AggregatorOutputRowLimit will be cancelled instead of being logged.
CookieAuthServerSidedatetime   Authenticate cookies server-side.
CustomIngestTokensboolean   Enable custom ingest tokens not generated by LogScale.
DefaultRolesForGroupsboolean   Assign default roles for groups.
DerivedCidTagboolean   Permit derived CID tag.
ExportToBucketboolean   Export data to bucket storage.
ExternalFunctionsboolean   External Functions.
FalconDataConnectorboolean   Uses the Falcon data connector.
FieldAliasingboolean   Allow field aliasing.
FleetCollectorDebugLoggingboolean   Enables fleet management collector debug logging.
FleetCollectorMetricsboolean   Enables fleet management collector metrics.
FleetEphemeralHostsboolean   Use Fleet ephemeral hosts.
FleetLabelsboolean   Allow Fleet Management labels.
FleetRemoteUpdatesboolean   Fleet remote updates features.
FlightControlboolean   Enable Flight Control support in cluster.
GeographyFunctionsboolean   Enable geography functions in query language.
GraphQueriesboolean   Enables graph queries.
LiveTablesboolean   Allow use of live tables.
LogAverageUsageboolean   Enables UsageJob to log average usage as part of usage log.
LoginBridgeboolean   Enable login bridge.
MacosInstallerForLogCollectorboolean   Enables download of macos installer for logcollector through fleet management.
ManagedRepositoriesboolean   Enable LogScale Managed repositories. The customer is not permitted to change certain configurations in a LogScale Managed repository.
ManagedRepositoriesAllowFDRConfigboolean   Allow users to configure FDR feeds for managed repositories.
MeasureNewSegmentFileFormatboolean   When using the new segment file format on write, also do the old solely for comparison.
MitreDetectionAnnotationboolean   Enable Mitre detection annotation.
MultiClusterSearchboolean   Enable searching across LogScale clusters.
MultipleViewRoleBindingsboolean   Enable multiple view role bindings.
NewOrganizationLimitsboolean   Use new organization limits.
NoCurrentsForBucketSegmentsboolean   Disable currents for Bucket segments.
OneToManyGroupSynchronizationboolean   Enables mapping one group to more than one LogScale group with the same lookup name during group synchronization.
OrganizationSecurityPoliciesboolean   Enable organization level security policies. For instance the ability to enable only certain action types.
PermissionTokensboolean   Enable permission tokens.
PreMergeMiniSegmentsboolean   Pre-merge mini-segments.
QueryAssistantboolean   Enable the LogScale Query Assistant.
QueryBacktrackingLimitboolean   Limit query backtracking.
RepeatingQueriesboolean   Whether the queries are repeating.
SleepFunctionboolean   Flag for testing, does nothing.
SubdomainForOrganizationsboolean   Enable subdomains for current cluster.
UsagePageUsingIngestAfterFieldRemovalSizeboolean   The UsagePage shows data from ingestAfterFieldRemovalSize instead of segmentWriteBytes.
WriteNewSegmentFileFormatboolean   Allow writing in new segment file format.