Delete an Existing Project

Permanently remove an app and revoke its API credentials along with the JWT tokens. This action cannot be undone.

Endpoint

DELETE /root/{app_id}

Headers

Name Type Required Description
Authorization string Yes The root-key of the project.

Example Request

curl --request DELETE \
--url http://{{you-endpoint}}:{{your-port}}/root/{{app-id}} \
--header 'Authorization: {{root-key}}'
const request = require('request');

const options = {
    method: 'DELETE',
    url: 'http://{{you-endpoint}}:{{your-port}}/root/{{app-id}}',
    headers: {Authorization: '{{root-key}}'}
};

request(options, function (error, response, body) {
    if (error) throw new Error(error);

    console.log(body);
});
import requests

url = "http://{{you-endpoint}}:{{your-port}}/root/{{app-id}}"

headers = {"Authorization": "{{root-key}}"}

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

print(response.json())
<?php
$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'http://{{you-endpoint}}:{{your-port}}/root/{{app-id}}', [
    'headers' => [
    'Authorization' => '{{root-key}}',
    ],
]);

echo $response->getBody();
package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {

    url := "http://{{you-endpoint}}:{{your-port}}/root/{{app-id}}"

    req, _ := http.NewRequest("DELETE", url, nil)

    req.Header.Add("Authorization", "{{root-key}}")

    res, _ := http.DefaultClient.Do(req)

    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)

    fmt.Println(res)
    fmt.Println(string(body))

}
AsyncHttpClient client = new DefaultAsyncHttpClient();
client.prepare("DELETE", "http://{{you-endpoint}}:{{your-port}}/root/{{app-id}}")
    .setHeader("Authorization", "{{root-key}}")
    .execute()
    .toCompletableFuture()
    .thenAccept(System.out::println)
    .join();

client.close();

Example Success Response

{
"status": "ok"
}

Response Fields

Field Type Description
status string Indicates whether the deletion was successful.

Responses

Status Code Description
200 Ok Success
400 Bad Request Mostly when the form validation fails. The error will be returned as a response.
403 Access Denied When the provided root key in Authorization header is invalid.
500 Internal Server Error Mostly because of the database error. Check the log for root cause details.