# delete\_\_organization\_{orgId}\_node\_{nodeId} `DELETE /organization/{orgId}/node/{nodeId}` *Delete Organization Node* Soft delete a node from the authenticated user's organization. This endpoint requires OWNER or ADMINISTRATOR role permissions and the node must belong to the specified organization. The node is not permanently removed but marked as deleted with a timestamp. **Important Notes:** * Only users with OWNER or ADMINISTRATOR roles can delete organization nodes * This is a soft delete operation - the node is marked as deleted but not permanently removed * Organization node quota will be decremented accordingly * Deleted nodes can be reactivated using the appropriate activation endpoint * The `deletedAt` field will be set to the current timestamp when the node is deleted #### Path Parameters | Name | Type | Required | Description | | -------- | ------ | -------- | --------------------------------------- | | » orgId | string | true | Unique identifier of the organization | | » nodeId | string | true | Unique identifier of the node to delete | #### TypeScript Client Library ```typescript // Using the Flashback TypeScript client import { FlashbackClient } from '@flashback/client'; const client = new FlashbackClient({ accessToken: 'your-access-token' }); // Delete an organization node try { const result = await client.deletePrivateNode('org-id', 'node-id'); console.log('Node deleted:', result); } catch (error) { console.error('Failed to delete node:', error); } ``` #### Code Samples {% tabs %} {% tab title="Shell" %} ```shell # You can also use wget curl -X DELETE https://backend.flashback.tech/organization/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001 \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}' ``` {% endtab %} {% tab title="HTTP" %} ```http DELETE https://backend.flashback.tech/organization/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001 HTTP/1.1 Host: localhost:3000 Accept: application/json Authorization: Bearer {access-token} ``` {% endtab %} {% tab title="JavaScript" %} ```javascript const headers = { 'Accept':'application/json', 'Authorization':'Bearer {access-token}' }; fetch('https://backend.flashback.tech/organization/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001', { method: 'DELETE', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); }); ``` {% endtab %} {% tab title="Ruby" %} ```ruby require 'rest-client' require 'json' headers = { 'Accept' => 'application/json', 'Authorization' => 'Bearer {access-token}' } result = RestClient.delete 'https://backend.flashback.tech/organization/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001', params: { }, headers: headers p JSON.parse(result) ``` {% endtab %} {% tab title="Python" %} ```python import requests headers = { 'Accept': 'application/json', 'Authorization': 'Bearer {access-token}' } r = requests.delete('https://backend.flashback.tech/organization/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001', headers = headers) print(r.json()) ``` {% endtab %} {% tab title="PHP" %} ```php 'application/json', 'Authorization' => 'Bearer {access-token}', ); $client = new \GuzzleHttp\Client(); try { $response = $client->request('DELETE','https://backend.flashback.tech/organization/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001', array( 'headers' => $headers, ) ); print_r($response->getBody()->getContents()); } catch (\GuzzleHttp\Exception\BadResponseException $e) { // handle exception or api errors. print_r($e->getMessage()); } ``` {% endtab %} {% tab title="Java" %} ```java URL obj = new URL("https://backend.flashback.tech/organization/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001"); HttpURLConnection con = (HttpURLConnection) obj.openConnection(); con.setRequestMethod("DELETE"); con.setRequestProperty("Accept", "application/json"); con.setRequestProperty("Authorization", "Bearer {access-token}"); 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()); ``` {% endtab %} {% tab title="Go" %} ```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/550e8400-e29b-41d4-a716-446655440000/node/660e8400-e29b-41d4-a716-446655440001", data) req.Header = headers client := &http.Client{} resp, err := client.Do(req) // ... } ``` {% endtab %} {% endtabs %} > Example responses > 200 Response ```json { "success": true, "message": "Node deleted successfully" } ``` > 400 Response ```json { "success": false, "message": "Node is already deleted" } ``` > 403 Response ```json { "success": false, "message": "Insufficient permissions: only OWNER and ADMINISTRATOR roles can manage nodes" } ``` > 404 Response ```json { "success": false, "message": "Node not found" } ``` > 500 Response ```json { "success": false, "message": "Internal server error" } ``` #### Responses | Status | Meaning | Description | Schema | | ------ | -------------------------------------------------------------------------- | ----------------------------------------- | ------ | | 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | Node deleted successfully | Inline | | 400 | [Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1) | Node is already deleted | Inline | | 403 | [Forbidden](https://tools.ietf.org/html/rfc7235#section-3.3) | Insufficient permissions or access denied | Inline | | 404 | [Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4) | Node not found | Inline | | 500 | [Internal Server Error](https://tools.ietf.org/html/rfc7231#section-6.6.1) | Internal server error | Inline | #### Response Schema Status Code **200** | Name | Type | Required | Restrictions | Description | | --------- | ------- | -------- | ------------ | --------------------------------------- | | » success | boolean | false | none | Indicates if the request was successful | | » message | string | false | none | Success message | Status Code **400** | Name | Type | Required | Restrictions | Description | | --------- | ------- | -------- | ------------ | --------------------------------------- | | » success | boolean | false | none | Indicates if the request was successful | | » message | string | false | none | Error message describing the issue | Status Code **403** | Name | Type | Required | Restrictions | Description | | --------- | ------- | -------- | ------------ | --------------------------------------------- | | » success | boolean | false | none | Indicates if the request was successful | | » message | string | false | none | Error message describing the permission issue | Status Code **404** | Name | Type | Required | Restrictions | Description | | --------- | ------- | -------- | ------------ | --------------------------------------- | | » success | boolean | false | none | Indicates if the request was successful | | » message | string | false | none | Error message describing the issue | Status Code **500** | Name | Type | Required | Restrictions | Description | | --------- | ------- | -------- | ------------ | ----------------------------------------- | | » success | boolean | false | none | Indicates if the request was successful | | » message | string | false | none | Error message describing the server issue | #### Security * **BearerAuth**: Bearer token authentication required * **Permissions**: Requires OWNER or ADMINISTRATOR role to manage organization nodes * **Organization Access**: User must belong to the specified organization * **Node Ownership**: Node must belong to the specified organization #### Notes * This is a soft delete operation - the node is marked as deleted with a timestamp but not permanently removed * Only users with OWNER or ADMINISTRATOR roles can delete organization nodes * Organization node quota will be decremented when a node is deleted * Deleted nodes will not appear in node listing endpoints but their data is preserved * A system event will be published when a node is successfully deleted * Deleted nodes can be reactivated using the appropriate activation endpoint --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.flashback.tech/support-reference/platform-api-reference/storage-apis/node-registration/delete__organization_-orgid-_node_-nodeid.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.