🎯API Stability
Long-TermThis API is stable and will remain supported across versions with minimal breaking changes.

Summary

The addStarToField() mutation marks a field in a repository or view with a star. Starred fields appear at the top of the field list in the LogScale user interface, making frequently used or high-priority fields easier to find.

Syntax

graphql
addStarToField(
      input: AddStarToFieldInput!
   ): AddStarToFieldMutation!

The mutation requires one input object. Provide the searchDomainName of the target repository or view and the fieldName to star. Both arguments are required.

The mutation returns an AddStarToFieldMutation object. Request the starredFields field to retrieve the updated list of starred fields after the mutation completes.

Hide Query Example

Show Currently Starred Fields Query

Example

Raw
graphql
mutation {
  addStarToField(input: 
       { fieldName: "connectionSource"
         searchDomainName: "humio" } )
  { starredFields }
}
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 {
  addStarToField(input: 
       { fieldName: \"connectionSource\"
         searchDomainName: \"humio\" } )
  { starredFields }
}"
}
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 {
  addStarToField(input: 
       { fieldName: \"connectionSource\"
         searchDomainName: \"humio\" } )
  { starredFields }
}"
}
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 { ^
  addStarToField(input:  ^
       { fieldName: \"connectionSource\" ^
         searchDomainName: \"humio\" } ) ^
  { starredFields } ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  addStarToField(input: 
       { fieldName: \"connectionSource\"
         searchDomainName: \"humio\" } )
  { starredFields }
}"
}'
    "$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 {
  addStarToField(input: 
       { fieldName: \"connectionSource\"
         searchDomainName: \"humio\" } )
  { starredFields }
}";
$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 {
  addStarToField(input: 
       { fieldName: \"connectionSource\"
         searchDomainName: \"humio\" } )
  { starredFields }
}"
}'''

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 {
  addStarToField(input: 
       { fieldName: \"connectionSource\"
         searchDomainName: \"humio\" } )
  { starredFields }
}"
}
);


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": {
    "addStarToField": {
      "starredFields": [
        "@timestamp",
        "connectionSource"
      ]
    }
  }
}

Input Parameters

Provide the searchDomainName of the target repository or view and the fieldName of the field to star. Both fields are required.

Table: AddStarToFieldInput Input Datatype

ParameterTypeRequiredDefaultStabilityAvailabilityDescription
fieldNameStringyes Long-Term The name of the field to mark with a star.
searchDomainNameStringyes Long-Term The search domain where the field can be found.

Returned Values

The mutation returns an AddStarToFieldMutation object. Request starredFields to retrieve the complete updated list of starred field names for the search domain.

Table: AddStarToFieldMutation Datatype

ParameterTypeRequiredDefaultStabilityAvailabilityDescription
starredFieldsStringyes Long-Term The fields on which to add stars.