delete__organization_{orgId}_key_{keyId}

DELETE /organization/{idOrg}/key/{idKey}

Delete Specific Organization Key

Delete a specific organization key by its ID. This operation is irreversible and will remove the key and its associated node relationships.

Important Notes:

• This operation deletes a specific key by its ID, not all keys for the organization

• All associated node-key relationships are also removed (cascade delete)

• This operation is irreversible - the key cannot be recovered

• System events are logged for audit purposes

• Any nodes using this specific key will need to re-register with a different key

Access Control:

• Requires ADMINISTRATOR or OWNER role within the organization

• Users can only delete keys for their own organization

• Key must exist and belong to the specified organization

Security:

• Key deletion is logged with detailed audit information

• System events are published for monitoring and alerting

• Private keys are permanently removed from the system

TypeScript Client Library

public deleteOrgKey = async (idOrg: string, keyId: string): Promise<{ success: boolean; message: string }> => {
  return this.makeRequest<{ success: boolean; message: string }>(`organization/${idOrg}/key/${keyId}`, 'DELETE');
};

Code Samples

Shell

# You can also use wget
curl -X DELETE https://backend.flashback.tech/organization/{idOrg}/key/{idKey} \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

HTTP

DELETE https://backend.flashback.tech/organization/{idOrg}/key/{idKey} HTTP/1.1
Host: localhost:3000
Accept: application/json
Authorization: Bearer {access-token}

JavaScript

const headers = {
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('https://backend.flashback.tech/organization/{idOrg}/key/{idKey}',
{
  method: 'DELETE',
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

Ruby

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.delete 'https://backend.flashback.tech/organization/{idOrg}/key/{idKey}',
  params: {
  }, headers: headers

p JSON.parse(result)

Python

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://backend.flashback.tech/organization/{idOrg}/key/{idKey}', headers = headers)

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

try {
    $response = $client->request('DELETE','https://backend.flashback.tech/organization/{idOrg}/key/{idKey}', array(
        'headers' => $headers,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

Java

URL obj = new URL("https://backend.flashback.tech/organization/{idOrg}/key/{idKey}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("DELETE");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{})
    req, err := http.NewRequest("DELETE", "https://backend.flashback.tech/organization/{idOrg}/key/{idKey}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Parameters

Name	In	Type	Required	Description
idOrg	path	string	true	Organization ID that owns the key
idKey	path	string	true	Unique identifier of the specific key to delete

Example responses

200 Response

{
  "success": true,
  "message": "Organization key deleted successfully"
}

403 Response

{
  "success": false,
  "message": "Access denied: you can only manage keys for your own organization"
}

404 Response

{
  "success": false,
  "message": "Organization key not found or does not belong to this organization"
}

500 Response

{
  "success": false,
  "message": "Internal server error"
}

Responses

Status	Meaning	Description	Schema
200	OK	Key deleted successfully	Inline
403	Forbidden	Insufficient permissions or access denied	Inline
404	Not Found	Key not found or doesn't belong to organization	Inline
500	Internal Server Error	Failed to delete key	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» message	string	false	none	Success message

Status Code 403

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» message	string	false	none	Error message describing the permission issue

Status Code 404

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» message	string	false	none	Error message indicating key not found

Status Code 500

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» message	string	false	none	Error message describing the internal error

To perform this operation, you must be authenticated by means of one of the following methods: BearerAuth