Terminate User

Permanently terminates a user account, revoking all access and invalidating all sessions and API keys.

danger

Terminating a user account is permanent and cannot be undone. All active sessions and API keys for the user will be immediately invalidated. Confirm the correct User ID before calling this endpoint.

Endpoint

DELETE /v2/users/{id}

Path Parameters

Parameter	Type	Required	Description
id	integer	Yes	The User ID of the account to terminate

Response

Returns a boolean indicating whether the termination was successful.

{
  "success": true,
  "data": true
}

Code Examples

cURL

curl -X DELETE "https://rest.ecgrid.io/v2/users/$ID" \
  -H "X-API-Key: $ECGRID_API_KEY"

C#

// .NET 10 — Terminate a user account using IHttpClientFactory
// WARNING: This action is permanent. Verify the userId before calling.
public async Task<bool> TerminateUserAsync(IHttpClientFactory httpClientFactory, int userId)
{
    var http = httpClientFactory.CreateClient("ECGridRest");

    var response = await http.DeleteAsync($"https://rest.ecgrid.io/v2/users/{userId}");
    response.EnsureSuccessStatusCode();

    var result = await response.Content.ReadFromJsonAsync<ApiResponse<bool>>();
    return result?.Data ?? false;
}

Java

import java.net.URI;
import java.net.http.*;

String apiKey = System.getenv("ECGRID_API_KEY");
String id = "0"; // replace with actual id

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(String.format("https://rest.ecgrid.io/v2/users/%s", id)))
    .header("X-API-Key", apiKey)
    .DELETE()
    .build();

HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

Node.js

const apiKey = process.env.ECGRID_API_KEY;
const url = `https://rest.ecgrid.io/v2/users/${id}`;

const response = await fetch(url, {
  method: 'DELETE',
  headers: { 'X-API-Key': apiKey },
});

const data = await response.json();
console.log(data);

Python

import os, requests

api_key = os.environ["ECGRID_API_KEY"]
headers = {"X-API-Key": api_key}
id = 0  # replace with actual id
url = f"https://rest.ecgrid.io/v2/users/{id}"

response = requests.delete(url, headers=headers)

response.raise_for_status()
print(response.json())

See Also

• Get User — verify user details before termination
• Reset Sessions — revoke active sessions without terminating the account
• List Users — review users before taking action