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

Summary

The deleteParserV2() mutation permanently deletes a parser from a repository. Deletion is irreversible. Export or document the parser configuration before deleting. Any data source assigned to the deleted parser reverts to default parser behavior after deletion. The mutation returns true on success, false if the parser does not exist, and null with errors if the operation fails for another reason, such as insufficient permissions.

Syntax

graphql
deleteParserV2(
      input: DeleteParserInput!
   ): Boolean

The mutation accepts a required input argument of type DeleteParserInput. This input requires the parser's unique identifier and the name of the repository that contains it. Use the parsers query shown in the Related section to retrieve parser identifiers.

The mutation returns a nullable Boolean. A true value confirms successful deletion. A false value indicates the parser was not found. A null value with errors indicates a failure condition such as insufficient permissions. The Input Parameters section lists all available fields.

Example

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

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 {
  deleteParserV2(input:
     { repositoryName: \"humio\", 
       id: \"abc123\"} ) 
}"
}
);


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

Input Parameters

Provide the unique identifier of the parser to delete and the name of the repository that contains it: