removeFileLabels()

Summary

When adding a file to LogScale, you can include as many as ten labels. At some point, though, you may want to delete some. To do this, use the removeFileLabels() GraphQL mutation. It will return information on the updated file, if successful — null with errors, if removal did not succeed.

There is not a mutation for changing labels. Instead, you'll have to use this mutation, and then use addFileLabels() to add new labels. Incidentally, to add a new file use the newFile() mutation.

Hide Query Example

Show File Labels Query

To get a list of all file labels, use the entitiesLabels() query like this:

graphql

query {
     entitiesLabels {
       entityTypes: File
     }
   }

To get a list of labels for a specific repository, you could execute the repository() like this:

graphql

query {
     repository ( name: "humio" )
       { files { labels } }
   }

For more information on files, see the Lookup Files documentation page.

Stability Level Long-Term

Syntax

graphql

removeFileLabels(
      input: RemoveFileLabels!
   ): File!

For the input, you have to give the name of the view or repository, and the name of the file from which you want to remove labels (click on Show Query below). You'll also have to provide, within brackets, a comma-separated list of labels to remove. See the Input Parameters section for details.

For the results, you can get details of the file, including a list of labels for it. See the Returned Values section farther down this page.

Hide Query Example

Show Files Query

To get a list of all files for a repository, use the repository() query like this:

graphql

query {
     repository(name: "humio")
        { files { nameAndPath { name, path } } }
   }

With these results you can use a file's name to remove labels from it.

Example

Raw

graphql

mutation {
  removeFileLabels(
    input: { 
      viewName: "humio",
      fileName: "my-file.txt",
      labels: [ "bobs-files" ]
    }
  )
  { labels }
}

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 {
  removeFileLabels(
    input: { 
      viewName: \"humio\",
      fileName: \"my-file.txt\",
      labels: [ \"bobs-files\" ]
    }
  )
  { labels }
}"
}
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 {
  removeFileLabels(
    input: { 
      viewName: \"humio\",
      fileName: \"my-file.txt\",
      labels: [ \"bobs-files\" ]
    }
  )
  { labels }
}"
}
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 { ^
  removeFileLabels( ^
    input: {  ^
      viewName: \"humio\", ^
      fileName: \"my-file.txt\", ^
      labels: [ \"bobs-files\" ] ^
    } ^
  ) ^
  { labels } ^
}" ^
} '

Windows Powershell and curl

powershell

curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  removeFileLabels(
    input: { 
      viewName: \"humio\",
      fileName: \"my-file.txt\",
      labels: [ \"bobs-files\" ]
    }
  )
  { labels }
}"
}'
    "$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 {
  removeFileLabels(
    input: { 
      viewName: \"humio\",
      fileName: \"my-file.txt\",
      labels: [ \"bobs-files\" ]
    }
  )
  { labels }
}";
$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 {
  removeFileLabels(
    input: { 
      viewName: \"humio\",
      fileName: \"my-file.txt\",
      labels: [ \"bobs-files\" ]
    }
  )
  { labels }
}"
}'''

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 {
  removeFileLabels(
    input: { 
      viewName: \"humio\",
      fileName: \"my-file.txt\",
      labels: [ \"bobs-files\" ]
    }
  )
  { labels }
}"
}
);


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": {
    "removeFileLabels": {
      "labels": [ "admin-files" ],
    }
  }
}

Input Parameters

For the input, you'll have to give the name of the file, and name of the related view or repository, and the labels you want to remove from the file. Click on the Show Query link under the Syntax section above for an example of how to get the file names.

Table: RemoveFileLabels Input Datatype

Parameter	Type	Required	Stability	Description
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: Nov 17, 2025
fileName	string	yes	`Long-Term`	The name of the file.
labels	[string]	yes	`Long-Term`	The labels to remove from the file, at most one-hundred at a time.
viewName	RepoOrViewName	yes	`Long-Term`	The name of the view of the file. RepoOrViewName is a scalar.

Returned Values

For the results, you can get information on the file, such as when it was created and last modified and by whom. More important to this mutation, you can use labels to get a list of labels associated with the file, in case you want to add some or remove more.

Table: File Datatype

Parameter	Type	Required	Stability	Description
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: Jul 24, 2025
allowedActions	[AssetAction]	yes	`Short-Term`	The allowed asset actions. See AssetAction . This is a preview and may be changed.
contentHash	string	yes	`Long-Term`	A content hash.
createdAt	datetime	yes	`Long-Term`	The date on which the file was created.
createdBy	string	yes	`Long-Term`	The author of the file.
fileSizeBytes	long		`Long-Term`	The file size in bytes.
labels	[string]	yes	`Preview`	The labels associated with this file.
modifiedAt	datetime	yes	`Long-Term`	The date and time the file was last modified.
modifiedBy	string	yes	`Long-Term`	The user who last modified the file.
nameAndPath	FileNameAndPath	yes	`Long-Term`	The name and path of the file. See FileNameAndPath.
package	PackageInstallation		`Long-Term`	The package, if any, associated with the file. See PackageInstallation.
packageId	VersionedPackageSpecifier		`Long-Term`	The package identifier. VersionedPackageSpecifier is a scalar.
resource	string	yes	`Short-Term`	The resource identifier for the file.

Versions of this Page

GraphQL Mutations

GraphQL API

GraphQL Queries

GraphQL Datatypes