๐ŸŽฏAPI Stability
Long-TermThis API is stable and will remain supported across versions with minimal breaking changes.

Summary

The deleteFile() mutation permanently removes a named file from a LogScale repository or view. Files are lookup resources โ€” typically CSV or JSON โ€” that queries reference by name for data enrichment using functions such as match() and lookup(). Deletion is immediate and irreversible; any saved searches, scheduled queries, or dashboards that reference the deleted file by name will produce errors at runtime after deletion.

The mutation returns a nullable Boolean: true on success, false when the file does not exist, and null with errors for other failures. To upload a new file, use newFile(). To replace an existing file's content without deleting it first, use updateFile().

Syntax

graphql
deleteFile(
      fileName: String!, name: String!
   ): Boolean

Both fileName and name are required. Provide the exact name of the file to delete and the name of the repository or view that contains it. The mutation returns a nullable Boolean: true on success, false when the file does not exist, and null when another error occurs.

Example

Raw
graphql
mutation {
  deleteFile(
      name: "humio",
      fileName: "my-lookup.csv"
    )
}
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 {
  deleteFile(
      name: \"humio\",
      fileName: \"my-lookup.csv\"
    )
}"
}
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 {
  deleteFile(
      name: \"humio\",
      fileName: \"my-lookup.csv\"
    )
}"
}
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 { ^
  deleteFile( ^
      name: \"humio\", ^
      fileName: \"my-lookup.csv\" ^
    ) ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  deleteFile(
      name: \"humio\",
      fileName: \"my-lookup.csv\"
    )
}"
}'
    "$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 {
  deleteFile(
      name: \"humio\",
      fileName: \"my-lookup.csv\"
    )
}";
$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 {
  deleteFile(
      name: \"humio\",
      fileName: \"my-lookup.csv\"
    )
}"
}'''

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 {
  deleteFile(
      name: \"humio\",
      fileName: \"my-lookup.csv\"
    )
}"
}
);


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": {
    "deleteFile": true
  }
}

Input Parameters

Provide the exact name of the file to delete and the name of the repository or view that contains it. The fileName value must match the filename exactly as stored โ€” the mutation treats the value as case-sensitive and does not support wildcards or partial matches.

Table: Input Parameters & Datatypes

Parameter Type Required Default Description
This table contains all input parameters for this mutation.
fileName string yes ย  The name of the file to delete. This must match the exact filename as stored in the repository or view. The value is case-sensitive and does not support wildcards.
name string yes ย  The name of the repository or view that contains the file.

Returned Values

This mutation returns a nullable Boolean. A value of true indicates the file was deleted successfully. A value of false indicates the file does not exist in the specified repository or view. A null value indicates another error occurred, such as insufficient permissions or an invalid repository name; check the errors field in the response for details. To confirm the file no longer exists, use the repository() query after the mutation completes.