delete__bucket_{bucketId}

DELETE /bucket/{bucketId}

Delete Bucket

Permanently delete a storage bucket. This operation is irreversible and will remove the bucket from the system.

Important Notes:

• Buckets cannot be deleted if they are currently being used by any storage repositories

• This endpoint respects workspace access controls. Users can only delete buckets within their accessible workspaces

• Deletion is soft-delete (marked as deleted but not physically removed from database)

• Organization bucket quota will be updated accordingly

TypeScript Client Library

public deleteStorageBucket = async (bucketId: string): Promise<ActionResponse> => {
  return this.makeRequest<ActionResponse>(`bucket/${bucketId}`, 'DELETE', null);
};

Code Samples

Shell

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

HTTP

DELETE https://backend.flashback.tech/bucket/{bucketId} HTTP/1.1
Host: localhost:3000
Accept: application/json

JavaScript

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

fetch('https://backend.flashback.tech/bucket/{bucketId}',
{
  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/bucket/{bucketId}',
  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/bucket/{bucketId}', headers = headers)

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

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

Java

URL obj = new URL("https://backend.flashback.tech/bucket/{bucketId}");
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{jsonReq})
    req, err := http.NewRequest("DELETE", "https://backend.flashback.tech/bucket/{bucketId}", data)
    req.Header = headers

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

Parameters

Name	In	Type	Required	Description
bucketId	path	string	true	Unique identifier of the bucket

Example responses

200 Response

{
  "success": true
}

Responses

Status	Meaning	Description	Schema
200	OK	Bucket deleted successfully	Inline
403	Forbidden	Insufficient permissions or bucket in use	Inline
404	Not Found	Bucket or user not found	Inline
500	Internal Server Error	Failed to delete bucket	Inline

Response Schema

Status Code 200

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

Status Code 403

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

Status Code 404

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

Status Code 500

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

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