Delete a Block

client.blocks.delete(args: DeleteBlockParameters): Promise<DeleteBlockResponse>

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_TOKEN })

const deletedBlock = await notion.blocks.delete({
  block_id: "your-block-id",
})

console.log("Block deleted:", deletedBlock.in_trash) // true
console.log("Deleted at:", deletedBlock.last_edited_time)

const blockIds = ["block-id-1", "block-id-2", "block-id-3"]

const deletePromises = blockIds.map(block_id =>
  notion.blocks.delete({ block_id })
)

const deletedBlocks = await Promise.all(deletePromises)
console.log(`Deleted ${deletedBlocks.length} blocks`)

async function deleteBlockSafely(blockId: string) {
  // First, retrieve the block to confirm what we're deleting
  const block = await notion.blocks.retrieve({ block_id: blockId })
  
  console.log(`About to delete ${block.type} block (ID: ${block.id})`)
  
  if (block.has_children) {
    console.warn("Warning: This block has children that will also be deleted")
  }
  
  // Proceed with deletion
  const deleted = await notion.blocks.delete({ block_id: blockId })
  return deleted
}

await deleteBlockSafely("your-block-id")

const block = await notion.blocks.delete({
  block_id: "your-block-id",
})

if (block.in_trash) {
  console.log("Successfully deleted:")
  console.log("  Block ID:", block.id)
  console.log("  Block type:", block.type)
  console.log("  Deleted by:", block.last_edited_by)
  console.log("  Deleted at:", block.last_edited_time)
}

// Only delete if block meets certain criteria
const block = await notion.blocks.retrieve({ block_id: "your-block-id" })

if (block.type === "paragraph" && block.archived) {
  // Only delete archived paragraphs
  await notion.blocks.delete({ block_id: block.id })
  console.log("Deleted archived paragraph")
} else {
  console.log("Block does not meet deletion criteria")
}

// First delete the block
await notion.blocks.delete({ block_id: "your-block-id" })

// Later, restore it from trash
const restored = await notion.blocks.update({
  block_id: "your-block-id",
  in_trash: false,
})

console.log("Block restored:", !restored.in_trash)

import { APIResponseError } from "@notionhq/client"

try {
  const deleted = await notion.blocks.delete({
    block_id: "your-block-id",
  })
  console.log("Block deleted successfully")
} catch (error) {
  if (APIResponseError.isAPIResponseError(error)) {
    switch (error.code) {
      case "object_not_found":
        console.error("Block not found or already deleted")
        break
      case "unauthorized":
        console.error("Not authorized to delete this block")
        break
      case "validation_error":
        console.error("Invalid block ID format")
        break
      default:
        console.error("API error:", error.code, error.message)
    }
  } else {
    console.error("Unexpected error:", error)
  }
}

async function deleteManyBlocks(blockIds: string[]) {
  const results = await Promise.allSettled(
    blockIds.map(block_id => notion.blocks.delete({ block_id }))
  )

  const successful = results.filter(r => r.status === "fulfilled")
  const failed = results.filter(r => r.status === "rejected")

  console.log(`Successfully deleted: ${successful.length}/${blockIds.length}`)
  
  if (failed.length > 0) {
    console.error(`Failed to delete ${failed.length} blocks:`)
    failed.forEach((result, index) => {
      if (result.status === "rejected") {
        console.error(`  Block ${blockIds[index]}: ${result.reason}`)
      }
    })
  }

  return { successful: successful.length, failed: failed.length }
}

const result = await deleteManyBlocks([
  "block-id-1",
  "block-id-2",
  "block-id-3",
])

// Archive a block (soft delete, easily reversible)
await notion.blocks.update({
  block_id: "your-block-id",
  archived: true,
})

// Delete a block (moves to trash, auto-deleted after 30 days)
await notion.blocks.delete({
  block_id: "your-block-id",
})