Hedera
Ask or search…
K
Comment on page

Delete a file

A transaction that deletes a file from a Hedera network. When deleted, a file's contents are truncated to zero length and it can no longer be updated or appended to, or its expiration time extended. When you request the contents or info of a deleted file, the network will return FILE_DELETED.
Transaction Signing Requirements
  • The key(s) on the file are required to sign the transaction
  • If you do not sign with the key(s) on the file, you will receive an INVALID_SIGNATURE network error
Transaction Fees
  • Please see the transaction and query fees table for base transaction fee
  • Please use the Hedera fee estimator to estimate your transaction fee cost
Constructor
Description
new FileDeleteTransaction()
Initializes the FileDeleteTransaction object
new FileDeleteTransaction()

Methods

V1
Method
Type
Description
setFileId(<fileId>)
FileId
The ID of the file to delete in x.y.z format
Java
FileDeleteTransaction transaction = new FileDeleteTransaction()
.setFileId(newFileId);
//Change the default transaction fee to 2 hbars
FileDeleteTransaction newMaxFee = transaction.setMaxTransactionFee(new Hbar(2));
//Prepare transaction for signing, sign with the key on the file, sign with the client operator key and submit to a Hedera network
TransactionId txId = newMaxFee.build(client).sign(key).execute(client);
//Request the receipt
TransactionReceipt receipt = txId.getReceipt(client);
//Get the transaction consensus status
Status transactionStatus = receipt.status;
System.out.println("The transaction consensus status is " + transactionStatus);
//v1.3.2
JavaScript
const transaction = new FileDeleteTransaction()
.setFileId(newFileId);
//Change the default transaction fee to 2 hbars
const newMaxFee = transaction.setMaxTransactionFee(new Hbar(2));
//Prepare transaction for signing, sign with the key on the file, sign with the client operator key and submit to a Hedera network
const txId = await newMaxFee.build(client).sign(key).execute(client);
//Request the receipt
const receipt = await txId.getReceipt(client);
//Get the transaction consensus status
const transactionStatus = receipt.status;
console.log("The transaction consensus status is " + transactionStatus);
//v1.4.4 (issue: returns unauthorized)

Get transaction values

V2
Method
Type
Description
getFileId(<fileId>)
FileId
The ID of the file to delete (x.z.y)
Java
//Create the transaction
FileDeleteTransaction transaction = new FileDeleteTransaction()
.setFileId(newFileId);
//Get the file ID
FileId getFileId = transaction.getFileId();
JavaScript
//Create the transaction
const transaction = new FileDeleteTransaction()
.setFileId(newFileId);
//Get the file ID
FileId getFileId = transaction.getFileId();
Go
//Create the transaction
transaction := hedera.NewFileDeleteTransaction().
SetFileID(fileId)
//Get the file ID
getFileId := transaction.GetFileID()