Summary

The deleteEventForwarder() mutation permanently removes an event forwarder from LogScale. Event forwarders route copies of ingested events to external destinations such as Kafka topics based on configured rules. Deletion takes effect immediately: LogScale stops forwarding matching events as soon as the mutation completes. This action cannot be undone.

To pause a forwarder without removing it permanently, use disableEventForwarder() instead. Before calling this mutation, use eventForwarders() to retrieve the forwarder's unique identifier.

API Stability Long-Term

Syntax

graphql
deleteEventForwarder(
      input: DeleteEventForwarderInput!
   ): Boolean!

The mutation takes a required input argument of type DeleteEventForwarderInput! containing the unique identifier of the event forwarder to delete. The mutation returns a non-null Boolean! value confirming whether the deletion succeeded.

Hide Query Example

Show Event Forwarder Identifiers Query

Example

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

Input Parameters

The DeleteEventForwarderInput input requires a single field: the id of the event forwarder to delete. Retrieve this value from the id field of any forwarder object returned by eventForwarders(). See the Syntax section for an example query.

Table: DeleteEventForwarderInput Input Datatype

ParameterTypeRequiredDefaultStabilityAvailabilityDescription
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: Oct 14, 2026 
idStringyes Long-Term The unique identifier of the event forwarder.

Returned Values

The mutation returns a non-null Boolean! value. A value of true indicates the event forwarder was successfully deleted. A value of false indicates the deletion did not complete. If the specified forwarder identifier does not exist or you lack the required permissions, LogScale returns an error rather than false.