๐ŸŽฏAPI Stability
Short-TermThis API may change in future versions. Use with caution in production environments.

Summary

The enableFeatureForOrg() mutation enables a specific feature flag for a named organization in LogScale. Use this mutation to activate experimental or optional capabilities for a single organization without affecting others. To enable the same feature globally across all organizations, use enableFeature() instead. To remove an enabled feature from an organization, use disableFeatureForOrg().

Syntax

graphql
enableFeatureForOrg(
      orgId: String!,
      feature: FeatureFlag!,
      skipVerification: Boolean
   ): Boolean!

The mutation requires the unique identifier of the target organization (orgId) and the feature flag to enable (feature). The optional skipVerification argument bypasses permission verification for the feature when set to true. The mutation returns a non-null Boolean! confirming whether the operation succeeded.

Example

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 $TOKEN = "TOKEN";

my $uri = '$YOUR_LOGSCALE_URL/graphql';

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

Input Parameters

Provide the unique identifier of the organization and the feature flag to enable. To find the organization identifier, select the Show Organizations Query link in the Related section for an example query.

Table: Input Parameters and Datatypes

Parameter Type Required Default Description
This table contains all input parameters for this mutation. Because one of the parameters uses a special datatype, an additional table is included below with its values.
orgId String yes ย  The unique identifier of the organization for which to enable the feature.
skipVerification Boolean ย  false Enables the feature flag regardless of permission verification. When omitted or set to false, the system verifies that the caller has permission for the feature before enabling it.

The feature parameter accepts a FeatureFlag enum value identifying the feature to enable for the organization. The following table lists the available enum values.